本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連接 SharePoint 資料來源
<a name="kb-managed-ds-sharepoint-connect"></a>

設定身分驗證並將登入資料存放在 AWS Secrets Manager 秘密之後，請在知識庫中建立 SharePoint 資料來源。此頁面說明如何使用 AWS 管理主控台 或 API 建立資料來源，後面接著您可以設定的連接器參數參考。

**注意**  
請先完成身分驗證設定。請參閱 [設定 SharePoint 的 Microsoft Entra ID 僅限應用程式身分驗證](kb-managed-sharepoint-entra-setup.md)（建議） 或 [設定 SharePoint 的 OAuth 2.0 身分驗證](kb-managed-sharepoint-oauth2-setup.md)。您需要憑證的秘密 ARN、租戶 ID 和 （僅限 Microsoft Entra ID 應用程式身分驗證） Amazon S3 位置。

## 建立資料來源
<a name="kb-managed-ds-sharepoint-create"></a>

------
#### [ Console ]

**將 SharePoint 連線至受管知識庫**

1. 在**資料來源**下，提供資料來源的名稱。

1. 從資料來源下拉式清單中選取 **SharePoint**。

1. 在**來源**下，輸入您的**網站 URLs**。每個 URL 必須以 開頭`https://`，並指向網站、團隊網站或個人網站 （例如 `https://contoso.sharepoint.com/sites/engineering`)。最多可以新增 100 個 URL。

1. 在**身分驗證**下，選取 **Microsoft Entra ID 僅限應用程式**或 **OAuth 2.0 身分驗證。**

1. 選取或建立 AWS Secrets Manager 秘密以存放您的登入資料。

1. 輸入您的**租用戶 ID**。

1. 如果您選取 Microsoft Entra ID 僅限應用程式身分驗證，請提供**憑證路徑**：`.p12`憑證檔案的 Amazon S3 路徑。

1. （選用） 若要啟用文件層級存取控制，請選取**使用 ACLs 控制文件存取**。此選項僅適用於 Microsoft Entra ID 僅限應用程式身分驗證，建立後無法變更。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-sharepoint-acl.md)。

1. （選用） 展開**同步範圍**以設定要抓取的內容 （檔案、頁面）。

1. （選用） 展開**日期型實體同步**以指定日期篩選條件。

1. （選用） 展開**項目路徑模式**，以新增特定路徑來篩選要爬取的項目。

------
#### [ API ]

若要建立 SharePoint 資料來源，請使用 Amazon Bedrock 的 Agents 建置時間端點傳送 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 請求。下列 AWS Command Line Interface 範例會建立使用 Microsoft Entra ID 僅應用程式身分驗證的資料來源。若要啟用文件層級存取控制，請將 `aclEnabled`設定為 `true`。如需每個欄位的說明，請參閱以下連接器參數參考。

```
aws bedrock-agent create-data-source \
 --name "{{SharePoint-connector}}" \
 --knowledge-base-id "{{your-knowledge-base-id}}" \
 --data-source-configuration file://sharepoint-managed-connector.json
```

`sharepoint-managed-connector.json` 檔案包含下列項目：

```
{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "SHAREPOINT",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-sharepoint-creds}}",
                "tenantId": "{{12345678-1234-1234-1234-123456789012}}",
                "authType": "ENTRA_ID_APP_ONLY",
                "certificateS3Path": {
                    "s3BucketName": "{{your-certificate-bucket}}",
                    "s3KeyName": "{{certs/certificate.p12}}"
                }
            },
            "dataEntityConfiguration": {
                "crawlFiles": true,
                "crawlPages": true,
                "siteUrls": [
                    "{{https://contoso.sharepoint.com/sites/engineering}}"
                ]
            }
        }
    }
}
```

對於`OAUTH2_APP`資料來源，將 `authType` 設定為 `OAUTH2_APP`並省略 `certificateS3Path`。

對於受管知識庫， `CreateDataSource`是非同步的：當操作完成`CREATING``AVAILABLE`時，資料來源狀態會從 轉換為 。

------

## 連接器參數
<a name="kb-managed-config-sharepoint"></a>

資料來源組態使用下列連接器參數。若要連線至 SharePoint，請在 中將 指定`SHAREPOINT`為連接器類型`connectorParameters`。如需包裝的欄位 `connectorParameters`（例如 `deletionProtectionConfiguration`和 `mediaExtractionConfiguration`)，請參閱 [連接資料來源](kb-managed-connect-ds.md)。


**connectionConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| secretArn | 是 | 包含 SharePoint 登入資料的 AWS Secrets Manager 秘密 ARN。 | 
| tenantId | 是 | Microsoft Entra (Azure AD) 租用戶 ID。 | 
| authType | 是 | 身分驗證類型： ENTRA\_ID\_APP\_ONLY（建議） 或 OAUTH2\_APP。請參閱 [身分驗證方法](kb-managed-ds-sharepoint.md#kb-managed-sharepoint-auth-methods)。 | 
| certificateS3Path | 有條件 | 即使停用 ACLs，身分ENTRA\_ID\_APP\_ONLY驗證仍為必要。包含 s3KeyName Amazon S3 中憑證檔案的 s3BucketName和 。未與 搭配使用OAUTH2\_APP。 | 


**dataEntityConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| siteUrls | 是 | 要爬取的 SharePoint 網站 URLs 清單。每個 URL 都是爬蟲進入點，必須以 開頭https://並指向網站、團隊網站或個人網站，路徑必須以 /sites/、 開頭/teams/，或以網站名稱 （例如 ) /personal/ 開頭https://contoso.sharepoint.com/sites/engineering。同時支援標準\*.sharepoint.com網域和自訂 （虛設） 網域。在每個網站中，連接器會編目檔案和頁面 （請參閱 crawlFiles 和 crawlPages)；若要以特定項目為目標，請使用 inclusionItemPaths。 | 
| crawlFiles | 否 | 是否要編目檔案。預設為 true。 | 
| crawlPages | 否 | 是否要編目頁面。預設為 true。 | 


**filterConfiguration （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| modifiedDateBefore | 否 | 僅包含在此日期之前修改的內容 (ISO 8601)。 | 
| modifiedDateAfter | 否 | 僅包含在此日期之後修改的內容 (ISO 8601)。 | 
| inclusionItemPaths | 否 | 要包含的特定項目路徑。當您提供 時inclusionItemPaths，連接器會編目這些項目，而不會驗證 siteUrls。 | 


**aclEnabled （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| aclEnabled | 否 | 設定為 true以啟用文件層級存取控制。需要ENTRA\_ID\_APP\_ONLY身分驗證。您無法在建立資料來源後變更此設定。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-sharepoint-acl.md)。 | 

## 變更身分驗證方法
<a name="kb-managed-ds-sharepoint-change-auth"></a>

您可以使用 [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) 操作或 ，透過使用新的 `authType`和 登入資料更新資料來源，來變更資料來源的身分驗證方法 （例如，從 OAuth 2.0 變更為僅限 Microsoft Entra ID 應用程式） AWS 管理主控台。文件層級存取控制設定會在您建立資料來源時修正，因此若要新增或移除 ACLs，您必須建立新的資料來源。

## 後續步驟
<a name="kb-managed-ds-sharepoint-connect-next"></a>

建立資料來源之後，請同步資料來源，以將內容擷取到您的知識庫。如需詳細資訊，請參閱[同步資料來源](kb-managed-sync.md)。若要依使用者許可篩選查詢結果，請參閱 [文件層級存取控制](kb-managed-ds-sharepoint-acl.md)。