FAQ content

Adding a new SIP2 configuration

In this article

Getting there

To create and manage your LibAuth profiles, go to LibApps > Admin > LibAuth Authentication.

Navigating to the Manage Authentication page
LibApps admin-level users can access LibAuth settings via the LibApps dashboard, under Admin > LibAuth Authentication.

Before you begin

Before setting up your new SIP2 configuration, you'll want to work with your IT staff on the following:

Permissions

  • Make sure your IT staff open your SIP2 port (usually 6000, 6001, or 6002 depending upon your ILS) to our server's IP address, which is listed on your LibAuth configuration page. This varies by region, as follows:
    • Canadian customers: 52.60.190.144
    • European customers: 34.251.14.142
    • Asia-Pacific customers: 13.237.173.81
    • All other customers: 54.235.93.96

Server Information

  • Obtain the fully qualified hostname or IP address of your SIP2 server from your IT staff.
  • Obtain the port number for your SIP2 server.
  • If your ILS requires a login for SIP2 authentication, be sure to get the appropriate username and password.
Your mileage may vary: we understand that everyone's authentication system may be set up differently than what's considered standard. Because we can't anticipate all of the possible setup variations, your mileage may vary from what's covered in these guides. Please work closely with your IT staff and don't hesitate to contact Springy Support if you need any help!

Adding a new SIP2 configuration

  1. If you have not yet created a LibAuth configuration, skip to Step 2. Otherwise, click on the Add Configuration button to create another one.

Screenshot of the Add Configuration button

  1. Below the Search for Your Institution dropdown, click on the Manual Configuration link.

Clicking to set up a manual configuration

  1. Select SIP2 as your authentication protocol.

Selecting the SIP2 protocol

  1. Under Server Info & Parameters, enter the information LibAuth will use to connect to your SIP2 server.
    1. Enter the hostname or IP address for your SIP2 server in the SIP2 Host field.
    2. Enter the port number used by your SIP2 server.
    3. If your ILS requires a login for SIP2 authentication, enter the username of the account to use.
    4. If your ILS requires a login for SIP2 authentication, enter the password of the account to use.
    5. If your ILS requires that you provide a location to log in, enter it in the Location Code field. Otherwise, leave this blank.
    6. If you would like to deny access to users with active blocks on their accounts in your ILS, set the Honor Patron Blocks Returned from ILS option to "Yes".
      • Otherwise, set this to "No" to ignore patron blocks and allow users to proceed with authentication.
      • For example, if this is set to "Yes" and a patron's account is blocked in your ILS, they would effectively be prevented from registering for events or bookings spaces & equipment where LibAuth authentication is required.

Server info & parameters fields

  1. Give your configuration a name.
  2. If you'd like, you can also provide notes or details about this configuration for your reference.
  3. Click the Save Configuration button.

The general fields and save configuration button