Verify the Platform to Troubleshoot Auth0 Issues
Verifying the platform and scoping issues helps narrow down the source of a problem when troubleshooting Auth0 implementations. Ensure the technology stack is on the latest version and run tests across different browsers, users, connections, and environments to identify the root cause of unexpected behavior.
- Auth0
- Troubleshooting
How is the platform verified to troubleshoot issues?
Ensure the technology stack uses the latest version by performing the following checks.
- Check the Auth0 support matrix to see whether the language or library versions used are supported.
- Compare versions of the technology stack across environments if a problem occurs in one environment (for example, development) but not in another (for example, production).
- Upgrade the technology stack and the browser to the latest versions, then test again before creating a support request.
What tests check the scope of the issue?
Testing across different browsers, platforms, locations, and users helps narrow down the source of a problem. Perform the following tests and review the logs in the Auth0 dashboard after each test for more information.
NOTE: Review the Monitoring page for more details on each log event that can assist with troubleshooting.
Test with different browsers
Determine if the issue is browser-specific by performing these tests.
- Determine whether the issue occurs across all browsers or only in specific ones.
- Test in a new incognito or private browser session to ensure no previous state exists.
- Upgrade to the latest browser version and re-test.
- Disable browser plugins and re-test to determine whether a plugin contributes to the issue.
Test with different users
Identify user-specific patterns by checking the following criteria.
- Determine if the issue occurs for all users or just specific ones.
- Identify any patterns, such as location, connection, or role, if only some users are affected.
Test with different connections and client applications (if using more than one)
Isolate the issue to specific connections or clients by doing the following:
- Determine whether the issue occurs with all connections or only one.
- Determine whether the issue occurs with all client applications or only one.
Test across different environments
Compare behavior across different setups by performing these actions.
- Test the development, staging, and production environments of the application.
- Test across different Auth0 tenants to identify any differences.
What factors determine the consistency of the issue?
Evaluate whether the issue is consistent or intermittent by checking these factors.
- Note the steps to reliably duplicate the issue if it is consistent.
- Note any pattern that might cause the issue if it is intermittent.
- Determine if the issue occurs with a new setup or if it worked previously and is now broken.
- Identify what changes were made if the setup recently broke.
- Determine if undoing the changes resolves the issue.
What checks isolate issues affecting only a few users?
Investigate issues limited to specific users by performing these checks.
- Check the user profile, browser, or device for any issues.
- Determine whether the issue occurs across all browsers for the affected users (indicating a data issue) or only in certain browsers (indicating a browser-specific issue).
- Verify that the browser has enabled JavaScript and cookies.
- Verify that the caps lock key is disabled.
- Check for any software that might impact authentication or authorization if the user is using a mobile device.
- Verify that the user can access key application URLs, such as the identity provider's Single Sign-On (SSO) URL, to rule out network connectivity issues.
What areas require investigation for post-deployment issues?
Troubleshoot issues that occur after a successful go-live by reviewing the following areas.
- Check for any recent changes to the application or any called APIs.
- Check for any recent network changes, such as load balancer, firewall, or proxy configuration updates.
- Check for any recent infrastructure changes, such as updated credentials for Lightweight Directory Access Protocol (LDAP) or DB servers.
- Check for any patches or updates to applications, infrastructure, or technology stacks.
- Verify that all servers run Network Time Protocol (NTP) and have accurate time synchronization.
- Check if any certificates have expired.
- Verify with the owners of any remote identity providers if anything has changed.
- Check network connectivity to any remote identity providers.
- Review notifications in the Auth0 dashboard/migrations for any overlooked changes.
- Review the Auth0 change log for any recent configuration changes related to the issue.
- Determine if any component in the technology stack was updated or patched recently.