> ## Documentation Index > Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # SharePoint Connector The SharePoint connector indexes documents, pages, and files from SharePoint Online into your knowledge base, enabling agents to search and retrieve SharePoint content. ## Specifications | Specifications | Details | | ---------------------------- | ----------------------------------------------------------------------------------------- | | Supported content | Articles, pages, and files in .doc, .docx, .ppt, .pptx, .html, .xhtml, .txt, .pdf formats | | Permission-aware ACL support | Yes | | Content filtering | Yes | | Delta Sync | Yes | You can configure the connector using either of the following authentication methods: * **Sign in with Microsoft** * **Azure App Registration (OAuth 2.0 Client Credentials)** ## Prerequisites Before configuring the SharePoint connector, ensure that: * You have a Microsoft 365 tenant with SharePoint Online and access to the SharePoint sites that you want to index. * For authentication: * You have permission to create Azure App Registrations and grant administrator consent. * An Azure App Registration has been created with the required Microsoft Graph API permissions. * If Permission-aware Search is enabled, the required Microsoft Entra ID permissions have been granted. ## Create the Azure App Registration Create an application in Microsoft Entra ID. 1. Sign in to the Azure portal. 2. Navigate to **Microsoft Entra ID** > **App registrations** > **New registration**. 3. Enter an application name (for example, **Artemis SharePoint Connector**). 4. Select **Accounts in this organizational directory only**. 5. Enter the **Redirect URI** as per your deployment. 6. Click **Register**. The application is created with: * **Application (Client) ID** - Use this as the **Client ID**. * **Directory (Tenant) ID** - Use this as the **Tenant ID**. ### Create a Client Secret 1. Open the registered application. 2. Navigate to **Certificates & secrets**. 3. Under **Client secrets**, click **New client secret**. 4. Enter a description. 5. Select an expiry period. 6. Click **Add**. 7. Copy the generated secret value immediately. This is your **Client Secret**. ## Configure Microsoft Graph Permissions 1. Open the registered application. 2. Navigate to **API permissions**. 3. Click **Add a permission**. 4. Select **Microsoft Graph**. 5. Select **Application permissions**. 6. Add the required permissions. 7. Click **Add permissions**. 8. Click **Grant admin consent** for your organization. ### Required Permissions The following permissions are required for all SharePoint connectors. | Permission | Purpose | | -------------- | ------------------------------------ | | Sites.Read.All | Read SharePoint site content. | | Files.Read.All | Read SharePoint documents and files. | | User.Read | Read user profile information. | These permissions provide read-only access. ### Additional Permissions for Permission-aware Search Enable Permission-aware Search to ensure search results respect SharePoint access permissions. When enabled, the connector retrieves Microsoft Entra group memberships before returning search results. Grant the following additional Microsoft Graph permissions. | Permission | Purpose | | -------------------- | ------------------------------------------- | | GroupMember.Read.All | Read Microsoft 365 group memberships. | | Directory.Read.All | Read Microsoft Entra directory information. | ## Configure the SharePoint Connector The SharePoint connector authenticates using OAuth 2.0 Client Credentials through Microsoft Entra ID. ### Step 1: Connect The **Connect** page establishes the connection between the platform and Microsoft SharePoint. **Connector Name:** Enter a unique name to identify the connector. **Authentication Method:** Select one of the following authentication methods. #### Sign in with Microsoft Authenticates using your Microsoft account through delegated permissions. The generated access token carries the signed-in user's identity and permissions. #### Azure App Registration Authenticates using an Azure App Registration. This is app-only communication method. Currently, only the Client Credentials authentication flow is supported. Provide the following details from your Azure App Registration and click **Connect**. | Field | Description | | ------------- | ------------------------------------------- | | Client ID | Azure Application (Client) ID | | Tenant ID | Microsoft Entra Directory (Tenant) ID | | Client Secret | Client secret generated for the application | The SharePoint connector requests read-only Microsoft Graph permissions. It never modifies SharePoint content, and all data is encrypted both in transit and at rest within your dedicated tenant partition. ### Step 2: Configure Scope and Filters After a successful connection, the connector discovers the available SharePoint environment and generates an ingestion proposal. Review or update the following settings before proceeding. | Field | Description | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Estimated Sync Impact | Displays the estimated number of selected sites, document count, storage size, and synchronization frequency. These values are estimates and may change after the first synchronization. | | What to Sync | Select the SharePoint sites to synchronize. Search by site name, URL, or Site ID. | | File Types to Include | Select the document formats to synchronize. | | Size Limit | Specify the maximum file size to synchronize. Files larger than the configured limit are skipped. | | Date Range | Synchronize only content created or modified within the selected date range. Leave blank to synchronize all eligible content. | | Exclude Patterns | Specify file or folder patterns to exclude from synchronization. | | Sync Schedule | Configure how frequently the platform synchronizes SharePoint content. | | Filter Rules | Define include or exclude rules to control which content is synchronized. | | Reset to Defaults | Restore all scope and filter settings to their default values. | Click **Save and Continue**. ### Step 3: Configure Field Mapping Configure how SharePoint metadata maps to your knowledge base schema. You can: * Select fields to synchronize. * Mark fields for embedding so they participate in vector search. * Map fields to canonical fields for metadata filtering. The connector templates prepopulate the default field mappings. After the first synchronization completes, any additional fields discovered in the indexed SharePoint content appear in the **Fields** tab for review and mapping. ### Step 4: Review and Sync Review the connector configuration and start the initial synchronization.