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

# 連接 Confluence 資料中心資料來源
<a name="kb-managed-ds-confluence-onprem-connect"></a>

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

**注意**  
首先完成 VPC 組態和身分驗證設定。請參閱 [設定資料來源的 VPC 連線](kb-managed-vpc-configuration.md) 和 [設定 Confluence Data Center 的基本或 PAT 身分驗證](kb-managed-confluence-onprem-auth-setup.md)。您需要 VPC 組態 ID 和秘密 ARN。

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

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

**將 Confluence 資料中心連線至您的受管知識庫**

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

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

1. 在 **VPC 組態**下，選取到達 Confluence 資料中心執行個體的 VPC 組態，或選擇**新增 VPC 組態**以建立組態。如需詳細資訊，請參閱[設定資料來源的 VPC 連線](kb-managed-vpc-configuration.md)。

1. （選用） 在**應用程式內容路徑**下，輸入提供 Confluence 資料中心 REST API **的內容路徑** （例如，`/wiki`)。如果在 Web 根目錄提供 REST API，請將其保留空白。

1. （選用，僅限 HTTPS) 在 **TLS 憑證**下，為您的 Confluence Data Center 執行個體提供 TLS 憑證的 Amazon S3 URI。

1. 在**身分**驗證下，選取**基本身分驗證**或**個人存取字符**，然後選取存放相符憑證的 AWS Secrets Manager 秘密。

1. （選用） 展開**同步範圍**以選擇要爬取的實體類型 （頁面、頁面附件、部落格、部落格附件、個人空間）。

1. （選用） 展開**實體 URLs**以使用 URL 型篩選來同步特定的 Confluence 空間、頁面和部落格。

1. （選用） 展開 **Mime 類型**以包含或排除特定 MIME 類型。

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

若要建立 Confluence Data Center 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 請求。下列 AWS Command Line Interface 範例會建立使用基本身分驗證的資料來源。若要改為使用個人存取字符，請將 `authType`變更為 `PERSONAL_TOKEN`。如需每個欄位的說明，請參閱以下連接器參數參考。

```
aws bedrock-agent create-data-source \
 --name "{{Confluence-DataCenter-connector}}" \
 --knowledge-base-id "{{your-knowledge-base-id}}" \
 --data-source-configuration file://confluence-onprem-connector.json
```

`confluence-onprem-connector.json` 檔案包含下列項目：

```
{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCEONPREM",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "authType": "BASIC",
                "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-onprem-creds}}",
                "contextPath": "{{/wiki}}",
                "vpcConfiguration": {
                    "vpcConfigurationId": "{{your-vpc-configuration-id}}"
                },
                "certificateS3Path": {
                    "s3BucketName": "{{my-cert-bucket}}",
                    "s3KeyName": "{{confluence-dc-cert.pem}}"
                }
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceUrls": ["{{https://confluence.example.com/spaces/ENG/}}"]
            }
        }
    }
}
```

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

------

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

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


**connectionConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| authType | 是 | 驗證類型。將 設定為 BASIC或 PERSONAL\_TOKEN。請參閱 [身分驗證方法](kb-managed-ds-confluence-onprem.md#kb-managed-confluence-onprem-auth-methods)。 | 
| secretArn | 是 | 包含 Confluence 資料中心登入資料的 AWS Secrets Manager 秘密 ARN。 | 
| vpcConfiguration | 是 | Confluence 資料中心執行個體的私有網路路徑。包含設定為知識庫上 VPC 組態 ID vpcConfigurationId的欄位集。請參閱 [設定資料來源的 VPC 連線](kb-managed-vpc-configuration.md)。 | 
| contextPath | 否 | 提供 Confluence 資料中心 REST API 的應用程式內容路徑 （例如，/wiki)。如果在 Web 根目錄提供 REST API，請將其省略。 | 
| certificateS3Path | 否 | 透過 HTTPS 連線時所使用的 Confluence Data Center 執行個體的 TLS 憑證位置。包含 s3BucketName和 s3KeyName。 | 


**dataEntityConfiguration （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| crawlPage | 否 | 是否要編目頁面。 | 
| crawlBlog | 否 | 是否要編目部落格文章。 | 
| crawlPageAttachment | 否 | 是否要編目頁面附件。只有在 crawlPage也是 時才會爬取true。 | 
| crawlBlogAttachment | 否 | 是否要編目部落格文章附件。只有在 crawlBlog也是 時才會爬取true。 | 
| crawlPersonalSpace | 否 | 是否要編目個人空間。 | 

**注意**  
與 Confluence Cloud 不同，Confluence 資料中心不支援編目封存空間或封存頁面。


**filterConfiguration （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| inclusionSpaceUrls | 否 | 要包含的空間 URLs。 | 
| inclusionPageUrls | 否 | 要包含URLs。 | 
| inclusionMimeTypes | 否 | 要包含的 MIME 類型。 | 
| exclusionMimeTypes | 否 | 要排除的 MIME 類型。 | 
| maxFileSizeInMegaBytes | 否 | 連接器擷取之任何單一檔案的大小上限，以 MB 為單位。提供 做為數值字串 （例如，"50")。 | 

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

您可以使用 [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) 操作或 ，使用新的 `authType`和包含相符登入資料的秘密來更新資料來源，以變更資料來源的身分驗證方法 （例如，從基本到個人存取字符） AWS 管理主控台。

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

建立資料來源之後，請同步資料來源，以將內容擷取到您的知識庫。如需詳細資訊，請參閱[同步資料來源](kb-managed-sync.md)。