Troubleshooting Issues

This document provides general troubleshooting guidance for Microsoft Entra integration.

Missing or Incomplete User Data

• The issue: 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

• The issue: 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

• The issue: 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

• The issue: 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

1. Regularly audit the Microsoft Entra tenant to ensure data completeness and accuracy.
2. Maintain up-to-date API credentials and verify that permissions match the required access scopes.
3. Test the integration in a sandbox environment to identify and resolve configuration issues before deploying to production.