Skip to main content

Articles in this section

See more

Setting Up Auth0 SSO in Academies

  • Last updated:

Please note that if you have more than one Academy, you will need to go set up SSO separately for each Academy. Academies cannot share the same SSO setup.

Getting Started

Navigate to your Academy Settings and select 'Registration'.

Uncheck the box for "Allow Registration via Username and Password" and check the box for "Allow Registration via SSO."

Note: If you would like to allow users to register using either username + password or SSO, you can check the box for both registration options.

For the SSO Type, please select OAuth:

Below is a list of settings that you will enter into WorkRamp

  • Client ID (Public client id used to distinguish this application)

  • Client Secret (Confidential password used in conjunction with the client id)

  • Authorization URL (Endpoint that we’ll redirect the browser for users to sign in)

  • Access Token URL (Endpoint that will be used to make the access token request)

  • User Data URL (Endpoint that will be used to request the user data)

  • Scope Parameters (List of parameters that will be used to send in authorization code request, this list will need to be space separated)

    • For Auth0, we would expect: openid profile email

User Info Response Parameters

  • First Name (Name of the parameter in user data response that contains user's first name)

    • For Auth0, we would expect: given_name

  • Last Name (Name of the parameter in user data response that contains user's last name)

    • For Auth0, we would expect: family_name

  • Email (Name of the parameter in user data response that contains the user’s email)

    • For Auth0, we would expect: email

Authorized Redirect URL: The callback endpoint is provided by WorkRamp and is located directly at the bottom of the Auth0 settings which your authorization server will redirect to containing the access token.

Please note that depending on your provider, you may need the Authorized Redirect URL first in order to configure the setup.

Running an SSO Test

Once you have finished setting up Auth0 SSO, we recommend running a quick test to make sure it works.

IMPORTANT: You should also run this test during non-peak hours or for a short period of time. This will lock out any users if the configuration is not set up properly.

In this article