FAQ content

LibAuth: Test & troubleshoot a Google OAuth 2 configuration

In this article

Getting there

  1. From the LibApps Dashboard, go to Admin > LibAuth Authentication.
  2. Click on the Edit () icon in the Actions 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.
Screenshot of the Test button
  1. Once you log into your system, 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.
Example of debugging information

What if I can't log in?

  • Double-check that you entered your username and password correctly.
  • Confirm that you've used the correct redirect URL in your Google OAuth 2.0 application.
  • Confirm that you have used the correct client identifier and secret from your Google OAuth 2.0 application.

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 and that the Google OAuth 2.0 application is configured correctly.

Example of a LibAuth response with no attributes
Example of a LibAuth response with no attributes