Patron authentication using a third party system

Find information about how to use a third party system for patron authentication in Relais ILL.

When an institution wants to use their organization's single sign on system to authenticate patrons, the institution must configure and implement the following:

Generate a URL

The URL can include any of the following tags:

 Note:  The values for the PI, PS, UL and RK tags can be encrypted.  See Security options for sending patron credentials for additional details.  

Tag Description
PI Patron ID
PS Patron surname
User Login

User Login

  • As defined in the patron record in Relais.
User Password

User Password

  • As defined in the patron record in Relais.
RK

Record key

  • The patron's internal record key in your library system.
PL Preferred Language
LS

Library symbol

  • As defined for your library in Relais.

 Caution: Library symbol must be included.


The tags you are required to include in the URL depend on which option Relais is using to retrieve patron information.  

  1. Option 1.  Using NCIP Lookup User to your local library system.  
    • If using NCIP, the credentials provided in the URL must be able to be used in the Lookup User message to be sent to the local library system.
    • The value in the PI tag must be the same patron ID as it is in your library system.
  2. Option 2.  Using a Relais patron record that was pre-loaded

Using the URL to retrieve patron information

Depending on which option is used, Relais will retrieve patron information in the following way.  

Option 1: Using NCIP

  • Uses the values from the xxx tags to generate an NCIP Lookup User message and sends it to the local library system to retrieve current patron information. 
  • Once the Lookup User response is received then the values are used to determine whether a patron exists for this library.
    • If yes, the values in the skeletal patron record in Relais are updated if appropriate.
    • If no, a Relais patron record is created using the values as described in NCIP generated patron records.

Option 2: Using a Relais patron record

  • Validates that the LS tag (Library Symbol) value is registered in Relais.  If this look up fails an error message is returned. 
  • Uses the value for the RK tag to determine whether a patron record exists for this library symbol.
    • If yes,  the value from the PI tag is compared with the value for the alternate patron ID in the record.
      • If the values are different, the patron record is updated. 
    • If no, a Relais patron record is created with the following values:
Relais field Relais database field Value
Patron ID PATRON_ID RK tag value
Library Symbol LIBRARY_ID Library ID associated with the LS tag
Alternate Patron ID ALT_PATRON_ID PI tag value
Patron Active flag PATRON_ACTIVE "Y"
Date record entered DATE_ENTERED Current system Date and Time
Patron Surname PATRON_SURNAME PS tag value
Preferred delivery method DELIV_METHOD "M"
Preferred messaging method MSG_METHOD "M"

 Note:  For this option, the PS (Patron Surname) tag is required.  If the PS tag has been omitted then the PI tag value is used.