Overview of Microsoft Graph connectors

Microsoft Search indexes all your Microsoft 365 data to make it searchable for users. With Microsoft Graph connectors, your organization can index third-party data to appear in Microsoft Search results. The third-party data can be hosted on-premises or in the public or private clouds. Connectors expand the types of content sources that are searchable in your Microsoft 365 productivity apps and the broader Microsoft ecosystem.

Important

DISCLAIMER: Microsoft Graph connectors and Microsoft Search APIs (query and index) are currently in preview status. To use connectors with Microsoft Search or to build connectors, you must sign up for the connectors preview program. To join the preview program, submit the Microsoft Graph connectors preview sign-up form.

Architecture

The following architectural diagram of the Microsoft Graph platform shows how connector content flows through content indexing to user results in Microsoft Search clients. This article explains each of the key building blocks in the Microsoft Graph connectors data flow process.

Diagram: on-premises and cloud-based data is pulled by connectors and indexed by the Microsoft Search API, and then the Microsoft Search service delivers the results to users.

The API instantiates one connection per data source. Then the API indexes and stores the data. Established connections interact with Microsoft Search, so users can get search results.

You can configure all the Microsoft-built connectors in the Microsoft 365 admin center. The admin center simplifies configuring your connector with a simple user interface.

To create a connection to a data source, admins need authenticated access to the data and the entire content repository. The data is fed to the graph connector service for indexing.

Available connectors

There are currently 6 Microsoft-built connectors, and over 100 connectors are available from our ecosystem partners.

To preview connectors from one of our ecosystem partners, contact them directly. For more information, see the Microsoft Graph connectors gallery.

You can also build your own connector.

Connectors by Microsoft

The Microsoft Graph connectors preview release includes 6 Microsoft-built connectors. You can set them up in the admin center and learn how to Set up your Microsoft-built connector.

The following sections provide brief descriptions for these Microsoft-built connectors. You can get more information in the linked articles for each connector.

  • Azure Data Lake Storage Gen2. With this Microsoft Graph connector, users in your organization can search for files and content stored in Azure Blob containers. The Azure Data Lake Storage Gen2 connector also indexes hierarchy-enabled folders in Azure Data Lake Storage Gen2 accounts that you specify. Learn more about the Azure Data Lake Storage Gen2 connector.

  • Enterprise websites. With this Microsoft Graph connector, users in your organization can search over pages in any non-SharePoint enterprise website. Learn more about the Enterprise websites connector.

  • File share. With this Microsoft Graph connector, users in your organization can search for files stored on on-premises Windows file shares. Learn more about the File share connector.

  • MediaWiki. With this Microsoft Graph connector, users can search for knowledge-base articles on wiki sites your organization creates with MediaWiki. Learn more about the MediaWiki connector.

  • Microsoft SQL server. With this Microsoft Graph connector, users in your organization can search for data in on-premises SQL server databases. Learn more about the Microsoft SQL server connector.

  • ServiceNow. With this Microsoft Graph connector, users in your organization can search for knowledge-base articles from your ServiceNow instance. Learn more about the ServiceNow connector.

Connectors from our partners

There are over 100 connectors available for preview from our ecosystem partners. To preview connectors from one of our ecosystem partners, contact them directly. Learn more about connectors from our partners in the Microsoft Graph connectors gallery.

Build your own connector

To index custom data types or files, developers can create connectors in Microsoft Graph. A connector is an application that creates a connection and pushes items into the Microsoft Search index. For more information, see the Overview for extending the Microsoft Search experience for apps on Microsoft Graph.

Search results with your custom-built connector

After custom data is indexed, developers can query this data. You can view your data in any application. For more information, see the Overview for extending the Microsoft Search experience for apps on Microsoft Graph.

License requirements

To view data from connectors in your search results, users must have one of the following Microsoft 365 subscriptions: