---
sourceDocument: Zurich ServiceNow AI Platform Administration
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/platform-administration

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Microsoft SharePoint Online external content connector

# Microsoft SharePoint Online external content connector {#ariaid-title1}

Release version: Zurich  
Updated August 4, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Microsoft SharePoint Online external content connector

The Microsoft SharePoint Online external content connector integrates content from your Microsoft SharePoint Online sites into ServiceNow AI Search applications.
It retrieves pages and metadata from SharePoint Online, making them searchable within your ServiceNow environment.
The connector supports both content crawls to update searchable content and user permissions crawls to update security principals, ensuring search results respect access rights.
Show full answer Show less  

## Key Features

* **Content Retrieval:** The connector accesses SharePoint Online pages stored as .aspx files, primarily extracting static content from metadata fields such as CanvasContent1 and WikiFields via the SharePoint REST API.
* **Limitations on Dynamic Content:** Pages that contain dynamic web parts may have partial or no content retrieved since the connector cannot impersonate users to render dynamic content fully.
* **Security and Permissions:** User permissions crawls update security principals to ensure search results comply with SharePoint access controls.
* **Indexing and Search Source Creation:** Retrieved content and metadata are indexed in a connector-specific source, which search administrators can link to search profiles for use in AI Search.
* **Configuration Requirements:** Setting up the connector involves creating an OAuth 2.0 app in Microsoft Entra admin center, generating a public/private key pair, and granting FullControl API permissions at the site or site collection level.
* **Customizable Crawl Scope:** Administrators can specify which SharePoint sites to crawl and apply filters to include or exclude document types, optimizing crawl scope and indexing focus.

## Practical Application for ServiceNow Customers

By integrating the Microsoft SharePoint Online external content connector, customers can:

* Make SharePoint Online pages and metadata searchable within ServiceNow AI Search, improving knowledge discovery across platforms.
* Ensure search results respect SharePoint security permissions through regular user permissions crawls.
* Configure and control which SharePoint sites and document types are included in search, tailoring search results to organizational needs.
* Understand the limitations on dynamic content retrieval, setting realistic expectations for searchable content completeness.

This connector enables a seamless search experience by bridging SharePoint Online content with ServiceNow's AI Search capabilities, enhancing information accessibility while maintaining security compliance.  
The Microsoft SharePoint Online external content connector retrieves pages from sites in your Microsoft SharePoint Online source system and makes their content and metadata searchable in AI Search applications.

Connector administrators can run
or schedule content crawls to retrieve updated content and access permissions from your source system, or user permissions crawls to retrieve updated security principals from your source system. Both types of crawl feed their data to AI Search for indexing.

The indexed content and metadata are stored as records in a connector-specific indexed source. Search administrators can create search sources from this
indexed source and link them to search profiles to make the indexed records searchable in AI Search applications.

## Microsoft SharePoint Online static and dynamic page content {#microsoft-sharepoint-online-external-content-connector__section_xpf_mrs_m3c}

Microsoft SharePoint Online pages built primarily with static text content authored in the Microsoft SharePoint Online editor produce searchable content that more closely matches what users see in a web browser. By contrast, pages that rely on dynamic web parts may not
contain all of the content that users see in a web browser.

Microsoft SharePoint Online pages are stored as .aspx files in a site's Site Pages library. These files can include static content in their CanvasContent1 and
WikiFields metadata fields, but they can also include scripts that call a server-side engine to dynamically render viewable content at request time. The exact content rendered depends on user context,
permissions, and web parts loaded as part of the page request.

Rendering a page's full viewable content requires an authenticated user session. The Microsoft SharePoint Online connector can't impersonate a user to trigger this rendering process. As a result, the connector cannot capture the final HTML output that a web browser
would display.

For each page retrieved, the Microsoft SharePoint Online connector queries the SharePoint REST API's _api/web/lists('\<list-id\>')/items(\<item-id\>) endpoint to access the page's underlying
list item. Via this API endpoint, the connector retrieves content primarily from the page's CanvasContent1 and WikiFields metadata fields, and also captures the page's other metadata fields such as title,
author, and modification date where available. Page content stored exclusively in dynamic web parts may be retrieved only partially or not at all, since that content doesn't exist in the list item
metadata.

To learn how to view the portion of a page's content that can be retrieved using the Microsoft SharePoint Online connector, see [View retrievable page content using the Microsoft SharePoint Online REST API](https://www.servicenow.com/docs/vLBX_vhxhes8nQ2_Tk6GFA "Review the elements of of a Microsoft SharePoint Online page's content that can be retrieved by the Microsoft SharePoint Online external content connector.").
* **[Estimate document volume for Microsoft SharePoint Online](https://www.servicenow.com/docs/b5s7i7~b52cMPEgONysPZA)**   
  Estimate the total number of documents included in your Microsoft SharePoint Online source system and the document counts for individual sites. Use this information to determine crawl scope settings needed for your Microsoft SharePoint Online external content connector.
* **[Create a public/private key pair for the Microsoft SharePoint Online external content connector](https://www.servicenow.com/docs/eDqVuiP73G3FrrYFQSs5dg)**   
  Generate a public/private key pair for the Microsoft SharePoint Online external content connector. Extract the public key as a DER-encoded binary X.509 format certificate for use in configuring API access for the connector in the Microsoft Entra admin center.
* **[Configure Microsoft SharePoint Online for external content indexing](https://www.servicenow.com/docs/_M7SXJ~zCIMy~2wtKyk29g)**   
  Register an OAuth 2.0 application in the Microsoft Entra admin center to grant the Microsoft SharePoint Online external content connector access to your Microsoft SharePoint Online source system.
* **[Configure site and site collection access for the Microsoft SharePoint Online external content connector](https://www.servicenow.com/docs/g1R3Anv6Ckvwiaqmoarykg)**   
  Allow the Microsoft SharePoint Online connector to crawl your sites and site collections by granting site-specific SharePoint API FullControl permissions to the OAuth 2.0 app registered in Microsoft Entra for the connector.
* **[Create a Microsoft SharePoint Online external content connector](https://www.servicenow.com/docs/aqTlyqMHUPsk_jbgRbjQ_w)**   
  Create an external content connector to retrieve searchable content and security principals from your Microsoft SharePoint Online source system.
* **[Configure crawl settings for the Microsoft SharePoint Online external content connector](https://www.servicenow.com/docs/F9LdeYq2Ao8VMnliu5hk4g)**   
  Specify the sites you want your Microsoft SharePoint Online external content connector to crawl. Define inclusion or exclusion filters for file extensions to dictate the types of documents the crawl retrieves and feeds to AI Search for indexing.
* **[View retrievable page content using the Microsoft SharePoint Online REST API](https://www.servicenow.com/docs/vLBX_vhxhes8nQ2_Tk6GFA)**   
  Review the elements of of a Microsoft SharePoint Online page's content that can be retrieved by the Microsoft SharePoint Online external content connector.

**Related tasks**   

* [Create a content crawl for an external content connector](https://www.servicenow.com/docs/~42Qr9c~jffY2LWWFQ4~xg "Retrieve searchable content and metadata from your source system with a content crawl. Run the crawl as a one-time task or schedule it to run on a recurring basis.")
* [Create a user permissions crawl for an external content connector](https://www.servicenow.com/docs/r_v78cGt6CPCfTE0BP7xlA "Retrieve security principals from your source system with a user permissions crawl. Run the crawl as a one-time task or schedule it to run on a recurring basis.")

