FAQ content

Testing and troubleshooting an LDAP 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 LDAP system.
  2. Enter the password you use for logging into your LDAP 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 IT staff opened your LDAP server port to our server's IP address.
  • Confirm that you entered the correct URL to your LDAP server.
  • Confirm that you selected the correct port for your LDAP server.
  • Confirm that you have entered the correct prefix and postfix for your LDAP setup. (A prefix is often needed and a postfix is always needed.)
  • Please review the full server information overview to double-check your configuration's settings and permissions.

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.

What does "Invalid DN Syntax" mean?

In a nutshell, this means your LDAP query did not contain the correct syntax. Confirm with your IT staff that you are using the correct LDAP prefix and postfix.

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