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.

Examples 

Given the permanent handle url for an item

http://hdl.handle.net/2027/mdp.39015015394847

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

https://shibboleth.umich.edu/idp/shibboleth

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

http://hdl.handle.net/2027/mdp.39015015394847?urlappend=%3Bsignon=swle:https://shibboleth.umich.edu/idp/shibboleth

  

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

https://www.hathitrust.org/?signon=swle:urn:mace:incommon:umn.edu

 

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

https://catalog.hathitrust.org/Record/007685144?signon=swle:https://shibidp.cit.cornell.edu/idp/shibboleth

 

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

Tip

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.