Skip to main content

Microsoft 365 overview

The Microsoft 365 connector provides shared authentication and identity crawling for SharePoint and OneDrive. Set up Microsoft 365 first, then configure SharePoint and OneDrive as child connectors that inherit the parent credentials.

Scope

This page describes the current Microsoft 365 setup, where SharePoint and OneDrive are child connectors and Outlook continues to be configured separately. The new guided setup also links Outlook to the suite. See Choose your Microsoft 365 setup for how the two compare.

How it works​

You register one app in Microsoft Entra ID. This app handles identity crawling for your Microsoft 365 tenant and provides credentials that SharePoint and OneDrive inherit automatically — there is no separate app registration for each child connector.

After saving the Microsoft 365 suite, configure SharePoint and OneDrive as child connectors. Each inherits the parent credentials and only requires child-specific configuration.

Glean adds a Microsoft 365 source link to each indexed user's people profile. Glean Support can customize these links when crawled user metadata contains the values needed to build the destination.

A custom template can reference a top-level string field, such as %{userPrincipalName}, or a nested string field with the %{field.path} format. Glean encodes each named field value before adding it to the link. Existing profile-link templates that use %s continue to work.

If a referenced field is missing or isn't a string, Glean leaves the source profile link empty. Contact Glean Support to configure a custom template.

Child connectors​

ConnectorWhat it indexesSetup
SharePointSites, pages, document libraries, files, and listsSharePoint setup
OneDrivePersonal drives and shared filesOneDrive setup

Permissions​

One Glean application in Microsoft Entra ID serves the whole suite. The parent connector handles identity permissions. Child connectors add their content permissions to the same app. See Request all suite permissions upfront for the complete list, and Set up Microsoft 365 for the full setup walkthrough.