FAQ content

Adding a new CAS 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 CAS configuration, you'll want to work with your IT staff on the following:

Permissions

  • 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

Server Information

  • 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.

Attributes

  • Obtain the attributes used for First Name, Last NameEmail, and User ID 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.

Add a new CAS 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 CAS as your authentication protocol.
Selecting the CAS protocol
  1. Under Server Info & Parameters, enter the full URL to your CAS system. This must begin with https:// and end with /serviceValidate.
Server URL field
  1. Configure the attributes released from your server.
    1. Enter the name of the attribute that contains the user's first name. (Optional, but recommended.)
    2. Enter the name of the attribute that contains the user's last name. (Optional, but recommended.)
    3. Enter the name of the attribute that contains the user's email address. (Required.)
    4. Enter the name of the attribute that contains the user's user ID. (Optional, but recommended.)
Attributes 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.
General fields & Save Configuration button