Skip to main content

TEAMS_LIVEMODE

Issue​

Glean couldn't validate the delegated permissions, tenant-wide consent, or OAuth callback required for Teams data fetching. An app credential or Microsoft Graph request failure can also prevent validation.

Resolution​

Read the message on the failed validation step, then update the default Teams crawler app registration whose client ID appears in the step name. Don't create a separate app for data fetching.

The validation message identifies the problem:

  • Missing Teams delegated scopes for all users lists missing permissions. It can also mean that users consented individually instead of an admin consenting for all users.
  • Missing Teams OAuth redirect URL for the default app includes the exact expected URL. No service principal or redirect URLs found for the application means Glean couldn't find the app's service principal or redirect URLs.

To add missing delegated permissions:

  1. In the Azure portal, go to Microsoft Entra ID → Manage → App registrations and select the app.
  2. Click Manage → API permissions, click Add a permission, and select Microsoft Graph.
  3. Choose Delegated permissions and add the missing permissions listed in the message. Glean requires offline_access, User.Read, Chat.Read, and ChannelMessage.Read.All.
  4. Click Grant admin consent for tenant. Consent from individual users doesn't pass this check.

To add the missing redirect URL:

  1. Copy the expected URL from the error message. It has this format:

    https://<your-Glean-backend-host>/instance/microsoftteams/oauth/verify_code

    Keep the shared lowercase path shown in the template, even for named connector instances. Don't substitute a connector instance name or the O365 callback path.

  2. On the same app registration, go to Manage → Authentication and add the URL as a redirect URI for the Web platform. The URL must match exactly, including the host, path, and letter case.

  3. Save the redirect URI, then retry enabling Data fetching in Glean.

If Glean can't get a token for the app, check that the credentials in the connector match the app registration. See Set up the Teams connector.

If the message reports an invalid deployment callback URL or Microsoft Graph repeatedly fails to return the app's details, contact Glean Support.

For additional assistance, contact Glean Support.

Was this page helpful?
On this page