This space contains the old OpenAthens SP documentation and is no longer maintained.
OpenAthens SP software is already out of support and reached end of life in May 2020.

Check out OpenAthens Keystone instead. It's supercool and makes dealing with SAML much easier.


Skip to end of metadata
Go to start of metadata


  • Application running under Apache on a Linux server in the Red Hat family - e.g. RHEL, CentOS.
  • Server time synchronised by NTP or similar
  • Familiarity with your chosen platform.
  • Access to the publisher dashboard.


  1. Add the OpenAthens repo to the /etc/yum.repos.d/ directory with a .repo extension, e.g: openathens.repo.

    name = yum repository for athens rpms
    baseurl =$releasever/sp/2.2/$basearch
    enabled = 1
    gpgcheck = 0
    failovermethod = priority

    For details see: Configuring Yum for OpenAthens SP

  2. Install OpenAthens SP

    sudo yum install openathens-sp

    For details see: Installing OpenAthens SP on Apache in detail


  3. Generate or install a metadata signing certificate - most federations allow these to be self-signed and last several years. Run the script in the /usr/share/atacama-platform/keys folder, or insert an existing .pem file in that folder containing both private and public keys.

    sudo ./ '' 'Short Description'

    For details see: Install metadata signing certificates on Apache

  4. If you have not already done so, create an application in the publisher dashboard. You will have the opportunity to paste in the signing certificate you generated in the previous step.when you set it up.

    1. If this is for an existing application, go to the connection for that application and add it in the SAML connector section.

  5. Configure the vhost - the publisher dashboard will have generated some web-server configuration to copy and paste. Add it with a .conf extension in the/etc/httpd/conf.d/ directory. In the file you must also:
    1. Update the SSL certificate and key references to the relevant locations.

    2. Update the protected location to cover your application.

    Finally restart Apache to download the configuration from the publisher dashboard and start using it.

For details see: Configuring Apache vhosts for OpenAthens SP

Configure your application

See OpenAthens SP common


You can optionally further restrict access in the vhost before passing the user to your application should you need or wish to. See: Restricting access via vhost.


  • No labels