In This Article

Testing and troubleshooting your SAML configuration

Getting there

  1. From the LibApps Dashboard, go to Admin > LibAuth Authentication.
  2. Click on the Edit () icon in the Action column for the configuration you want to manage.

Editing a LibAuth configuration


Testing your configuration

After creating or modifying your LibAuth configuration, it's always a good idea to test it. This will confirm whether or not LibAuth can connect to your authentication system and that your system is returning the necessary attributes to LibAuth. The testing tool will provide debugging info that you can use to troubleshoot any issues.

  1. Save your configuration, then click on the Test button in the Test This Configuration box at the top of the page.
  2. Enter your user credentials to log into your authentication system.
  3. You will then receive a summary of test results. This will indicate whether or not you are logged in, as well as debug info to help you troubleshoot any problems. For example, it will indicate any attributes that were not successfully released by your server or correctly mapped in your configuration.

Screenshot of the Test button

Example of logging into an authentication system

Example of debugging information 


What if I can't log in?

  • Double check that you entered your username and password correctly.
  • Confirm that your IT staff added Springshare as an authorized service provider using the correct Entity ID.
  • If you are a member of InCommon or UK Confederation, confirm that you provided the correct entityID of your SAML configuration.
  • Otherwise, confirm that you entered the correct URL to your SAML metadata XML file.

LibAuth did not receive our attributes. How do I know if they were released?

When testing your configuration, the debug information contains a raw_response array. If the attributes are being released, they will be listed here. However, if the array contains no data (i.e. there's nothing between the curly braces), then the attributes are not being released. Contact your IT staff to ensure that the attributes are being released to LibAuth.

Example of a LibAuth response with no attributes


Our attributes were released, but LibAuth is not receiving the user data. What happened?

It's likely that the attributes were not mapped correctly in your LibAuth configuration. The debug information contains a raw_response array listing the name of the released attributes, along with their corresponding data. Check your LibAuth configuration's attribute settings to ensure that the values you entered in the First Name, Last Name, and Email fields match exactly what you see in the debug info. (The attribute names will all be displayed within brackets)

Example of debug info highlighting the released attribute names

Still need help? No worries! If you are having issues and the above troubleshooting steps haven't helped, contact Springy Support for further assistance. We are happy to work with you and your IT staff to resolve any issues. :)

Related Articles