Available Indexes

Automatic Login for Partner Institutions

By wrapping a HathiTrust url or item handle with a single sign-on URL, it is possible to construct a link to a HathiTrust web page or to a work in the collection that automatically passes users from HathiTrust partner institutions through their institution's authentication service, effectively "automatically" logging them into HathiTrust.

URLs must be constructed in the following way:

  • Links to digital items: http://hdl.handle.net/2027/$ID?urlappend=%3Bsignon=swle:$ENTITY_ID
  • Links to the home page: https://www.hathitrust.org/?signon=swle:$ENTITY_ID
  • Links to catalog records: https://catalog.hathitrust.org/Record/$RECORD_ID?signon=swle:ENTITY_ID

Where $ID is the HathiTrust item ID (for example mdp.39015015394847), $RECORD_ID is the catalog record ID (for example 007685144), and $ENTITY_ID is your Shibboleth identity provider (IdP) entity ID.


Given the permanent handle url for an item


...and the Shibboleth IdP entity ID for University of Michigan


...you can append the "signon" parameter to automatically pass users through your institution's Shibboleth IDP:



Given the HathiTrust homepage and the Shibboleth IdP entity ID for University of Minnesota: 



Given a catalog record url and the Shibboleth IdP entity ID for Cornell University: 



Websites serving multiple organizations

If you are managing a catalog or website that serves users from multiple campuses or organizations, the above structure won't work because it only allows you to list one entity ID in the syntax. Instead, you can set up automatic login links that direct your users to our login screen first, where they have to select their organization from the dropdown list under "Find your partner institution." 

URLs must be constructed in the following way:

  • Links to digital items: http://hdl.handle.net/2027/$ID?urlappend=%3Bsignon=swle:wayf
  • Link to the home page: https://www.hathitrust.org/?signon=swle:wayf
  • Links to catalog records: https://catalog.hathitrust.org/Record/$RECORD_ID?signon=swle:wayf


To find the Shibboleth entity id for your organization, go to the list of InCommon Federation Entities and search for your organization on the page. Select the name of your organization, and a popup box with provide some basic information about the identity provider. Select the link to "more technical info", and the Entity ID will be listed in the box. 

Please contact feedback@issues.hathitrust.org with any questions or comments.