This document provides general troubleshooting guidance for Microsoft Entra integration. For advanced issues or questions, please refer to the Microsoft Teams Integration or contact Edlink support.
Common Issues and Resolutions
Missing or Incomplete User Data
What this issue means: The Microsoft Entra tenant does not have all required user information populated.
How to fix it:
- Ensure that all user profiles include key fields such as names, roles, and email addresses.
- Verify that the Microsoft Entra directory is configured correctly and that Edlink has access to it.
Permission Denied
What this issue means: Edlink does not have the necessary permissions to access the Microsoft Entra directory.
How to fix it:
- Verify that API access is enabled and permissions have been granted for Edlink.
- Confirm that the Microsoft Entra application registration includes the correct scopes for identity synchronization.
Single Sign-On (SSO) Login Issues
What this issue means: Users are unable to log in using their Microsoft credentials.
How to fix it:
- Check the Microsoft Entra configuration to ensure that SSO is properly enabled.
- Verify that user accounts in the Microsoft Entra tenant are active and not locked or disabled.
API Rate Limits
What this issue means: Edlink encounters rate-limiting errors from the Microsoft Entra API.
How to fix it:
- Monitor the frequency of API calls made to Microsoft Entra and ensure compliance with rate limit guidelines.
- Implement backoff strategies in your integration logic to handle rate limit responses gracefully.
Best Practices for Avoiding Issues
- Regularly audit the Microsoft Entra tenant to ensure data completeness and accuracy.
- Maintain up-to-date API credentials and verify that permissions match the required access scopes.
- Test the integration in a sandbox environment to identify and resolve configuration issues before deploying to production.
For additional troubleshooting or custom implementation guidance, please reach out to Edlink support.