Auth0 Single Sign-On Setup

Authenticating OpsLevel with Auth0

The Opslevel Single Sign-On authentication method can be used with your organization's existing Auth0 identity provider by configuring a SAML integration. Below are the detailed steps on how to get started using Auth0 and SAML

Setting up an Auth0 SAML Application

To set up an Auth0 SAML application, first:

  1. From the Auth0 dashboard, navigate to the Applications tab.
  2. Press + Create Application button on the Applications page:

    Auth0 Create Application Screen

  3. You will be shown a Create Application modal.
  4. Name your application (example: OpsLevel).
  5. Select Regular Web Applications.
  6. Press the Create button:

    Auth0 Create Application Modal with Regular Web Applications Selected.

  7. After successfully creating the application, navigate to the Addons tab.
  8. Select the SAML2 WEB APP tile:

    Auth0 Application Addons Tab

  9. Enter the following callback URL for OpsLevel into the Application Callback URL input box:

                        
    https://app.opslevel.com/users/auth/callback
                      
  10. Modify the Settings block to look like the following mapping:

                        
    {
      "mappings": {
        "user_id": "nameidentifier",
        "email": "email",
        "name": "name",
        "given_name": "firstname",
        "family_name": "lastname"
      }
    }
                      

    Completed Auth0 SAML2 Settings form.

  11. Navigate to the Usage tab
  12. Download and open the Auth0 certificate. Use the value of this certificate as the input for the X.509 certificate field under the Authentication Method portion of your Opslevel account settings.

    Location of Auth0 Certificate to download.

  13. Copy the Identity Provider Login URL from Auth0 and paste it into the Opslevel Authentication Method SAML settings.

    Identity Provider URL to be copied.

  14. Save the OpsLevel settings
  15. Navigate back to the Auth0 SAML2 Modal Settings tab in Auth0.
  16. Ensure your settings have been saved and test out your brand-new Auth0 App!

If you are having trouble setting up your single sign-on in any way, send us an email at info@opslevel.com and we'll be happy to help debug and diagnose any issues.