Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • An OpenAthens customer domain and access to the OpenAthens admin area (
  • An OpenAthens personal account under that customer domain for testing
  • The EntityID for your doman - this can be found in the OpenAthens admin area under Management > Connections


Create the application in the OpenAthens publisher dashboard

Go to, sign in and follow these steps:

  • Click the register new application button and choose OpenAthens SP in the dialogue box
  • Name your application. Eventually this will be customer facing, but for now it can be anything
  • Application URL: this is the root web address of the application - e.g:
  • Leave 'users in my domain' ticked, but keep the other options unticked
  • Click the create button. This creates the application record and a connection

At this point you're presented with a getting started guide in the dashboard that should provide you with enough to implement OpenAthens SP on your JEE Web application.


Code Block
├── pom.xml
└── src
    └── main
        ├── java
        │   └── uk
        │       └── org
        │           └── eduserv
        │               └── iam
        │                   └── simplesp
        │                       ├──
        │                       ├──
        │                       └──
        └── resources
            ├── atacamaKeystore.jks
            └── templates
                ├── homepage.html
                └── subscriptionContent.html


With all that done, run your application class and you'll hopefully have a working OpenAthens SP install.


At the moment your service provider is only connected to your customer domain. For very small applications that may be all you need, but it is more likely you'll want to join the federation as soon as possible and for that you will need to get production ready.