Versions Compared

Key

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

The OpenAthens discovery service Wayfinder uses the SAML DS protocol and as long as your SP software does too it is just a case of configuring it. Some common SPs are covered below:

Table of Contents

OpenAthens SP or OpenAthens Cloud

For both OpenAthens SP and OpenAthens Cloud, the procedure is the essentially the same.

  1. Sign in to the publisher dashboard (https://sp.openathens.net)

  2. Select the application in question and go to its configuration tab

  3. Scroll to the  discovery method section and select the radio button for the central discovery service

  4. If it doesn't already say so in the box, enter https://discoverywayfinder.openathens.net  

  5. Save changes

OpenAthens Cloud will start to use the this discovery service immediately.

...

Code Block
languagexml
For OpenAthens SP:
<idpdisc:DiscoveryResponse Binding="urn:oasis:names:tc:SAML:profiles:SSO:idp-discovery-protocol" Location="https://yourdomain.com/oa/disco-ret" index="1"/>"

For OpenAthens Cloud:
<idpdisc:DiscoveryResponse Binding="urn:oasis:names:tc:SAML:profiles:SSO:idp-discovery-protocol" Location="http://connect.openathens.net/saml/2/auth" index="1"/>

See also: Discovery

Shibboleth

You will need to do three things:

...

Code Block
xml
xml
 <SSO
     discoveryProtocol="SAMLDS" discoveryURL="https://discoverywayfinder.openathens.net">
     SAML2 SAML1
 </SSO>

...

  • Once you are logged in at sp.openathens.net, select your application
  • Go to the SAML endpoints tab and click the add endpoint button
  • Select discovery return URL, enter the value and click done
  • Click Save changes
  • It will take up to 15 minutes for the change to take effect

SimpleSAML.php

Set the options in authentication.php:

  • 'discoURL'  => 'https://discoverywayfinder.openathens.net' 
  • 'idp' => null

...

  • Once you are logged in at sp.openathens.net, select your application
  • Go to the SAML endpoints tab and click the add endpoint button
  • Select discovery return URL, enter the value and click done
  • Click Save changes
  • It will take up to 15 minutes for the change to take effect

Other SP software

Add according to their instructions and then update the federation metadata as above.