Skip to main content
Skip table of contents

Integrating OpenAthens Keystone with Auth0

Set up an application in OpenAthens

  1. Create an application in the OpenAthens Service Provider dashboard. See:

    1. Quickstart for OpenAthens Keystone

    2. Add an application

  2. In the Redirect URL field, enter a placeholder URL for now. You will update this field later, after configuring Auth0. Fill in the other fields as required.

    Form for creating a new OpenID Connect application. There are three mandatory input fields labeled 'Name', 'Application URL' and 'Redirect URL'. There is also an option to 'Connect via' 'A new connection' or 'An existing connection'. At the bottom of the page are buttons labeled 'Create application' and 'Cancel'.

  3. Save the application.

  4. Go to Keystone settings > Keystone connections and select the connection for your new application.

  5. In the Rules section of your connection details, turn on Shortened OIDC subject (52 characters). (You might need to click Show all to see this rule.)

    Details tab of a connection called 'Auth0 connection'. It shows a partial list of rules, including 'Shortened OIDC subject (52 characters)', and the option to 'show all' rules. Each rule can be switched on or off. At the top of the page is a button labeled 'Save changes'.

  6. Save your changes.

Configure Auth0

Log in to your Auth0 dashboard and configure the required settings, as described in the Auth0 documentation.

You can find the ClientID and Client Secret in the OpenAthens Service Provider dashboard (Applications > [select your application] > Configuration tab).

Update the redirect URL

Back in the Service Provider dashboard, update the Redirect URL of your application with the correct URL from Auth0.

You can now test authentication.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close