FAQ content

Testing and troubleshooting a self-hosted configuration

In this article

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. Enter the username you use for logging into your self-hosted system.
  2. Enter the password you use for logging into your self-hosted system.
  3. Click the Test button.
  4. Review the test results.
    • If the test was successful, a confirmation message will display showing you the data retrieved for each attribute.
    • If the test was unsuccessful, you will be presented with debug information that explains the issue. Use this to help troubleshoot any issues with your configuration.

Example of testing an LDAP configuration

What if I can't log in?

  • Double check that you entered your username and password correctly.
  • Confirm that your system is allowing connections from our server's IP address.
  • Confirm that you entered the correct URL to your self-hosted server.
  • Confirm that the correct data format was selected as the return type.
  • Confirm that the return text matches the success message sent by your system.

Why couldn't LibAuth receive our attributes?

When testing your configuration, the debug information will indicate which (if any) attributes were empty. This will indicate if no data was received for each of the attributes listed in your LibAuth configuration. Confirm with your IT staff that you are using the correct attribute names, then try again.

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. :)