--- sourceDocument: Xanadu ServiceNow AI Platform Administration sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/platform-administration Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Create a Microsoft Teams external content connector # Create a Microsoft Teams external content connector {#ariaid-title1} * Release version: Xanadu * * Updated June 26, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read Create an external content connector to retrieve searchable content and security principals from your Microsoft Teams source system. ## Before you begin A source system administrator must have already configured your Microsoft Teams source system to allow access by the Microsoft Teams external content connector. For details on configuring these settings in the source system, see [Create a public/private key pair for the Microsoft Teams external content connector](https://servicenow-prod.fluidtopics.net/vYmusdOeu_ImjKbQbGAEbw "Generate a public/private key pair for the Microsoft Teams 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.") and [Configure Microsoft Teams for external content indexing](https://servicenow-prod.fluidtopics.net/LAx5NxO~VY3V7QUb_bSvqQ "Register an OAuth 2.0 application in the Microsoft Entra admin center to allow the Microsoft Teams external content connector to access your Microsoft Teams source system."). If your Microsoft Teams tenant is in the Microsoft 365 GCC or GCC High cloud or the Microsoft 365 DoD cloud, you must have already configured the Microsoft cloud service endpoint URL. For instructions on configuring this setting, see [Configure the Microsoft cloud service endpoint URL](https://servicenow-prod.fluidtopics.net/C~75IQWy491bOo36SkmQlg "Specify the proper cloud service endpoint URL to use for external content connectors that crawl your Microsoft cloud application tenants."). Role required: admin ## Procedure 1. Navigate to AllExternal Content ConnectorsExternal Content Admin Home. 2. If prompted, select Switch scope to switch to the External Content Connectors Admin scope. You need to be in this scope to create or edit external content connectors. 3. In the Connectors section, select New. 4. On the Choose source page, select the SharePoint Online tile, then select Next. 5. On the Connector details page, fill in the required connection settings. {#create-ext-cont-connector-msteams__table_uvz_jrv_sdc__entry__2} | Connection setting | Description | |-|-| | Connector name | Unique name for this Microsoft Teams external content connector. | | Application (client) ID | Application (client) ID for the OAuth 2.0 application defined in the Microsoft Entra admin center that grants access to your Microsoft Teams source system. If you have access to the OAuth 2.0 application's registration record in the Microsoft Entra admin center, you can navigate to Overview and copy this ID from the Application (client) ID field in the Essentials section. If you can't access the OAuth 2.0 application's registration record in the Microsoft Entra admin center, ask your Microsoft Entra administrator for the application's Application (client) ID value. | | Directory (tenant) ID | Directory (tenant) ID for the OAuth 2.0 application defined in the Microsoft Entra admin center that grants access to your Microsoft Teams source system. If you have access to the OAuth 2.0 application's registration record in the Microsoft Entra admin center, you can navigate to Overview and copy this ID from the Directory (tenant) ID field in the Essentials section. If you can't access the OAuth 2.0 application's registration record in the Microsoft Entra admin center, ask your Microsoft Entra administrator for the application's Directory (tenant) ID value. | | JKS Certificate | Java KeyStore (JKS) file containing a public/private key pair generated with the Java keytool utility. These keys must match the public key from the DER-encoded binary X.509 format certificate uploaded to the OAuth 2.0 application defined in the Microsoft Entra admin center that allows the Microsoft Teams external content connector to access your source system data. If you don't have a copy of the JKS file, ask your security administrator for it. You can't download the JKS file from the OAuth 2.0 application's registration record in the Microsoft Entra admin center. | | JKS certificate password | Password for the Java KeyStore (JKS) file specified in JKS Certificate. If you don't have the password for the JKS file, ask your security administrator for it. You can't retrieve the JKS certificate password from the registration record for the OAuth 2.0 application defined in the Microsoft Entra admin center that allows the Microsoft Teams external content connector to access your source system data. | | JKS certificate thumbprint (Base 64) | Base64-encoded thumbprint SHA1 hash for the DER-encoded binary X.509 format public key certificate uploaded to the OAuth 2.0 application defined in the Microsoft Entra admin center that allows the Microsoft Teams external content connector to access your source system data. If you don't have this value, ask your Microsoft Entra administrator for the base64-encoded thumbprint SHA1 hash for the application's DER-encoded binary X.509 format public key certificate. | [ ] {#create-ext-cont-connector-msteams__table_uvz_jrv_sdc} 6. Select Save and validate. Note: If validation fails, an error message appears. Double-check your connection settings to ensure they're correct. ## Result Your new Microsoft Teams external content connector appears in the Connectors section. ## What to do next You can optionally define crawl settings for your new Microsoft Teams external content connector. Using these settings, you can limit the set of teams you want the connector to crawl, or define the file extensions for documents you want the connector's crawls to include or exclude. To learn how to configure the connector's crawl settings, see [Configure crawl settings for the Microsoft Teams external content connector](https://servicenow-prod.fluidtopics.net/4T6MXH8DM972U3dS4ZZRnQ "Specify the teams you want your Microsoft Teams 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."). If you want the connector to crawl everything in the source system, and don't want to apply file-extension inclusion or exclusion filters, you can skip definition of crawl settings and go straight on to define a crawl schedule for your new connector or run one-time crawls for it. For details on defining a crawl schedule, see [Define a crawl schedule for an external content connector](https://servicenow-prod.fluidtopics.net/XCXxlqJZb8I1hurNFcj9JQ "Keep your search index up to date by scheduling regular document and user mapping crawls for your external content connector. Scheduled crawls can run daily or on selected days of the week, starting at a time that you specify."). To learn about running one-time crawls, see [Run a one-time full or partial document crawl for an external content connector](https://servicenow-prod.fluidtopics.net/WF27NJ6iuXMWR2w_4osxvw "Retrieve document content and metadata from all or part of your external content connector's data source on demand. A document crawl sends retrieved content and metadata to AI Search for indexing, making them available to users of your AI Search applications.") and [Run a one-time user mapping crawl for an external content connector](https://servicenow-prod.fluidtopics.net/y6XALmRIpXNR6kXFwU19LQ "Retrieve users and group access permissions from your external content connector's data source on demand. A user mapping crawl maps retrieved user and group permissions to your ServiceNow AI Platform users to facilitate content security in your AI Search applications."). You can create search sources for the connector's indexed source and link them to your search profiles. To view the connector's indexed source, navigate to AllAI SearchAI Search IndexIndexed Sources. For information about creating search sources and linking them to search profiles, see [Search sources in AI Search](https://servicenow-prod.fluidtopics.net/rRLONKzjnEhenBae4lDmeg "Define search sources to make your searchable content available in search experiences. Choose an indexed source and configure optional filter conditions to limit the content that users can search."). *[\>]: and then