Auth0 setup

Control access to Bugsnag using Auth0.

Setup

To configure Bugsnag with Auth0:

  1. In Bugsnag settings select Organization -> Single sign-on (Admin access is required):

    • Copy the SAML endpoint URL to your clipboard. Configure SSO
  2. In Auth0, create a new application that includes the SAML2 addon.

  3. Paste the URL copied from Bugsnag in the Application Callback URL field.

  4. In the Settings tab for your application

    • Click on Show Advanced Settings at the bottom of the screen.
    • Select the Endpoints tab.
    • Copy the value from the SAML Metadata URL to your clipboard.
  5. Add a SAML Attributes mapping Rule to map email addresses to the nameidentifier field:

    • Click on Rules in the sidebar.
    • Select Create Rule.
    • Select SAML Attributes Mapping from the Enrich Profile section.
    • Create the rule with the following code:
    function (user, context, callback) {
      context.samlConfiguration.mappings = {
        "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier": "email",
      };
      callback(null, user, context);
    }
    
  6. In Bugsnag:

    • Paste the Metadata URL in the SAML/IdP metadata URL from your SSO provider field.
    • Select Auto-provision users on first login if you would like accounts to be automatically created for new users. Users will be granted access to all current projects but will not be given admin access. Users will only be added up to your plan’s collaborator limit.
    • Select Enable SSO.
  7. You can now log in to Bugsnag from Auth0.