Breadcrumbs

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. Following the page title and intro text is a button labeled 'Add application'.

  3. Press Create new application. A pop-up window opens, asking you to choose the type of application.

    Pop-up window titled 'Add application'. Following the question 'What type of resource do you want to connect' is a choice of two options, 'Open ID relying party' and 'Existing SAML entity'. 'OpenID Connect relying party' is selected. At the bottom of the window are 'Next' and 'Cancel' buttons.

  4. Choose OpenID Connect relying party and press Next.

  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 titled 'New OpenID Connect application'. It reads, 'Your application has been created. A connection has also been set up to connect your application to your selected identity providers.' Links to suggested next steps follow this message.

Return to main integration page