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

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

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

**注意**  
請先完成身分驗證設定。請參閱 [設定 Confluence 的基本身分驗證](kb-managed-confluence-basic-setup.md) 或 [設定 Confluence 的 OAuth 2.0 身分驗證](kb-managed-confluence-oauth2-setup.md)。您需要秘密 ARN 和 Confluence 主機 URL。

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

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

**將 Confluence 連接到您的受管知識庫**

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

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

1. 在**來源**下，輸入您的 Confluence URL （例如，`https://example.atlassian.net`)。

1. 在**身分**驗證下，選取**基本身分驗證**或 **OAuth 2.0 身分驗證。**

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

1. （選用，僅限基本身分驗證） 若要啟用文件層級存取控制，請選取**使用 ACLs 控制文件存取**。您選取的秘密必須包含 `adminApiKey`、 `organizationId`和 `directoryId`。此選項無法在建立後變更。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-confluence-acl.md)。

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

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

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

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

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

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

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

```
{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCE",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-basic-creds}}",
                "type": "SAAS",
                "authType": "BASIC",
                "hostUrl": "{{https://example.atlassian.net}}"
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceKeys": ["{{ENG}}", "{{DOCS}}"]
            }
        }
    }
}
```

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

------

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

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

**`aclEnabled` 明確設定**  
如果您省略 `aclEnabled`，預設值取決於 `authType`：`BASIC`預設值為 `true`，`OAUTH2`預設值為 `false`。由於 ACL 組態在資料來源建立後是永久的，因此`aclEnabled`請明確設定 ，讓資料來源具有您想要的存取控制行為。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-confluence-acl.md)。


**connectionConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| secretArn | 是 | 包含 Confluence 登入資料的 AWS Secrets Manager 秘密 ARN。 | 
| type | 是 | Confluence 部署類型。設定為 SAAS。不支援 Confluence Server 和資料中心。 | 
| authType | 是 | 驗證類型。將 設定為 BASIC或 OAUTH2。請參閱 [身分驗證方法](kb-managed-ds-confluence.md#kb-managed-confluence-auth-methods)。 | 
| hostUrl | 是 | Confluence Cloud 執行個體的基本 URL （例如 https://example.atlassian.net)。 | 


**dataEntityConfiguration （選用）**  

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


**filterConfiguration （選用）**  

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


**aclEnabled （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| aclEnabled | 否 | 文件層級存取控制是否已啟用。設定為 true 以啟用，或false設定為停用。如果您省略此欄位，預設值取決於 authType：BASIC預設值為 true；OAUTH2預設值為 false。上的 ACL BASIC需要包含 Atlassian 組織管理員憑證的秘密。您無法在建立資料來源後變更此設定。如需詳細資訊，請參閱[文件層級存取控制](kb-managed-ds-confluence-acl.md)。 | 

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

您可以使用 [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) 操作或 ，使用新的 `authType`和包含相符憑證的秘密更新資料來源，以變更資料來源的身分驗證方法 （例如，從 OAuth 2 AWS 管理主控台.0 變更為基本）。文件層級存取控制設定會在您建立資料來源時修正，因此若要新增或移除 ACLs，您必須建立新的資料來源。

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

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