For Developers

Troubleshooting Issues

This document provides troubleshooting guidance for OAuth2 integrations, including some common issues. For further assistance, contact Edlink support or your Customer Success Manager.

Common Issues & Resolutions

Addressing common OAuth2 issues early can help ensure a smooth integration and prevent disruptions for users accessing connected platforms.

Mismatched Emails/Usernames

  • Issue: Person not found.
    • Potential Resolution: Verify that the email or username in the primary data source matches the identifier in the OAuth2 provider exactly.

Login Failures

  • Issue: Authentication fails during login.
    • Potential Resolution: Confirm that the OAuth2 provider setup (e.g., client ID, client secret, redirect URI) is correctly configured within Edlink.
    • Potential Resolution: Check the OAuth2 provider configuration to ensure the application is set up with the appropriate redirect URI and scopes.

Unsupported Provider

  • Issue: The OAuth2 provider does not fully comply with OAuth2 standards.
    • Potential Resolution: Switch to a provider that adheres to OAuth2 specifications.
    • Potential Resolution: Verify that the provider supports the required grant types (e.g., Authorization Code Grant, Client Credentials Grant).

Scope Issues

  • Issue: Users do not have access to required data.
    • Potential Resolution: Check that the requested scopes in the OAuth2 configuration (e.g., openid, email, profile) match the data required for the integration.
    • Potential Resolution: Update the scope settings in both the OAuth2 provider and the Edlink configuration.

For further assistance with OAuth2 troubleshooting, contact Edlink support or your Customer Success Manager.