Skip to main content
Skip table of contents

Adding a new OIDC application to the service provider dashboard step by step

  1. Access the service provider dashboard at https://sp.openathens.net.

  2. From the menu, go to Applications.

    Main Applications page, showing a list of current applications and a button labeled 'Create new application'.
  3. Press Create new application. A pop-up window opens, asking you to choose the type of application.

    Pop-up window titled 'Create new application'. It shows two options, 'OpenID Connect - Configure an application supporting OpenID Connect' and 'Existing SAML application - Configure an application running third-party SAML software, such as Shibboleth'. At the bottom of the window are buttons labeled 'Configure' and 'Cancel'.
  4. Choose OpenID Connect and press Configure.

  5. Fill in the form on the next page.

    Form titled 'New OpenID Connect application'. It has three input fields, 'Name', 'Application URL' and 'Redirect URL', plus the option to connect via 'a new connection' or 'an existing connection'. Following the form are buttons labeled 'OK' and 'Cancel'.

  6. The following fields can be changed later if necessary, but must be valid to proceed.

    1. Name - this will ultimately appear in-front of OpenAthens customers, but can be anything for now - there's a check on this when you publish things later

    2. Application URL - the root address of the website where you are installing your OIDC software e.g. https://auth.yourdomain.com

    3. Redirect URL - this is where your OIDC software is expecting the user to be returned after authentication. /redirect is often used but is not universal. If you're not sure, or if your OIDC software's documentation doesn't say what it should be, you can leave it as is and update it later (if it's wrong the first test you run will fail at the address you should be using)

  7. Select a new connection unless you are setting up to migrate from one OIDC application to another.

  8. Click the Create application button.

  9. This will create the record and display the details you need to configure your OIDC plugin.

    Confirmation page that reads 'Your application has been created. A connection has also been set up to connect your application to your selected identity providers.' Following this text are 'next steps.

Return to main integration page

JavaScript errors detected

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

If this problem persists, please contact our support.