To create and manage your LibAuth profiles, go to LibApps > Admin > LibAuth Authentication.
Before setting up your new CAS configuration, you'll want to work with your IT staff on the following:
- Your IT staff must add Springshare as an authorized service provider using the provider URL listed on the configuration page. This URL will vary by region, as listed below:
- European customers: https://eu.libauth.com
- Canadian customers: https://ca.libauth.com
- Asia-Pacific customers: https://au.libauth.com
- All other customers: https://libauth.com
- Confirm with your IT staff that your server supports the CAS 2.0 or 3.0 protocol, which is what LibAuth will use to communicate with it.
- Obtain the URL to your CAS system from your IT staff.
- Obtain the attributes used for First Name, Last Name, and Email from your IT staff.
- If you want to set up group permissions, you'll need to know the names of certain attributes (such as status or department), along with their possible values.
- For example, if you have an attribute for "Department", you'll want to know the names of the departments that you can pick from.
- This will allow you to create group permissions so you can restrict access to things by department.
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 CAS 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 CAS as your authentication protocol.
- Enter the URL to your CAS system provided by your IT staff.
- Configure the attributes released from your server.
- Enter the field name of the attribute that contains the user's first name. (Optional, but recommended.)
- Enter the field name of the attribute that contains the user's email address. (Required.)
- Enter the field name of the attribute that contains the user's last name. (Optional, but recommended.)
- Give your configuration a name.
- If you'd like, you can also provide notes or details about this configuration for your reference.
- Select "Yes" or "No" to indicate if you would like to use your LibAuth configuration to sign into LibApps.
- This will give users the option of signing into LibApps using either their LibApps username & password, or via CAS.
- Please note that this does not replace the LibApps login page.
- Click the Save Configuration button.