This page will take you through the basics of creating an application in the service provider dashboard (https://sp.openathens.net) and publishing it in the OpenAthens Federation. It will get you quickly to a state where you can test that it “works-at-all”. This page will not get you production ready.
When you are ready, there are separate pages that cover getting production ready.
If you are using OpenID Connect (with OpenAthens Keystone)
You will need to install OpenID Connect software suitable for your platform before you get to step 6.
-
Go to Applications and add a new application, choosing OpenID Connect relying party in the dialog box.
-
Name your application. Eventually this will be customer facing, but for now it can be anything.
-
Application URL: this is the root of your application, e.g: https://login.yourdomain.com.
-
Redirect URL: this is where we will return the user after authentication, e.g. https://login.yourdomain.com/oidc/redirect.
-
Select to Connect via a new connection. You can change this setting later.
-
Press the Create application button. The basic application record is now set up.
You will not yet be production ready, but you will be at a place where you can test with your OpenAthens accounts at the location you enabled during install.
For more details, see:
If you are using other SP software (e.g. Shibboleth)
-
Go to Applications and add a new application, choosing Existing SAML entity in the dialog box.
-
Provide your SAML entity’s metadata either by specifying its URL or by uploading the file. Any type of text file is fine, as long as it has valid XML inside it.
-
Confirm that the metadata is trusted and should be imported, then click Create application. This creates the basic application record.
-
Add the OpenAthens Federation metadata to your SP configuration. (See also: How to add the OpenAthens Federation to common SP software.)
You are not yet production ready, but you can now test with your OpenAthens accounts.
See also: