To create and manage your LibAuth profiles, go to LibApps > 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:
- 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: 18.104.22.168
- European customers: 22.214.171.124
- Asia-Pacific customers: 126.96.36.199
- All other customers: 188.8.131.52
- 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.
Adding a new SIP2 configuration
- If you have not yet created a LibAuth configuration, skip to Step 2. Otherwise, click on the Add Configuration button to create another one.
- Below the Search for Your Institution dropdown, click on the Manual Configuration link.
- Select SIP2 as your authentication protocol.
- Under Server Info & Parameters, enter the information LibAuth will use to connect to your SIP2 server.
- Enter the hostname or IP address for your SIP2 server in the SIP2 Host field.
- Enter the port number used by your SIP2 server.
- If your ILS requires a login for SIP2 authentication, enter the username of the account to use.
- If your ILS requires a login for SIP2 authentication, enter the password of the account to use.
- If your ILS requires that you provide a location to log in, enter it in the Location Code field. Otherwise, leave this blank.
- 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.
- Give your configuration a name.
- If you'd like, you can also provide notes or details about this configuration for your reference.
- Click the Save Configuration button.
- Learn how to customize the login form for your SIP2 configuration.
- Learn how to add group permission rules to your new configuration.
- Learn how to allow users to log in to LibApps with this configuration.
- This gives you the option to only allow users to log in via your SSO.
- Learn how to test and troubleshoot your SIP2 configuration.