Versions Compared


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


Download data from OpenAthens

  1. Go to advanced search and craft a search to return all relevant accounts across your domain - e.g. active accounts that are not expired across you and all sub-organisations.

  2. From the results, select the checkboxes for the relevant accounts (the select all option may be what you need
    Awesome Icon
    Awesome Icon

  3. Click the actions button that has appeared and use the download option. Depending on how many accounts you are dealing with, this may take a few seconds or several minutes. If you have a very large number of accounts (say 70,000 or more) you may not be able to download them all in one file.

  4. Once ready there will be a success box with a link to the file page. If you miss the select box, you can access the download file via the big downloads button on the homepage (
    Awesome Icon

  5. Download the file to your computer - it is the data under persistentUID that you will need to add to your local accounts in your system. 


  1. Using your skill and judgement, match up the downloaded persistentUID data with the relevant users in your systems and add it to your directory.

  2. Ensure that the attribute holding this data will be passed to us when the user signs in

    1. LDAP - should just work

    2. SIRSI - you will usually need to re-use one of the standard attribute attributes such as patronInfo.alternativeID.

    3. ADFS, CAS, SAML - ensure the attribute is included in the ones you release to us

    4. API - the attribute and value only need to be in the payload for the relevant users 


  1. Go to your connection (Management > Connections > Connector) and select the attributes tab

  2. Add a mapping

    1. The source attribute should be whichever attribute in your system contains the PUID values. This The name is case sensitive.

    2. The target name must be AthensMDLegacyPUID

    3. The display name can be whatever you like - perhaps 'Legacy PUID'

    4. Leave the releasable option cleared

  3. Click on the done and then save changes buttons