連接 Confluence 資料來源

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

注意

請先完成身分驗證設定。請參閱設定 Confluence 的基本身分驗證或設定 Confluence 的 OAuth 2.0 身分驗證。您需要秘密 ARN 和 Confluence 主機 URL。

建立資料來源

Console

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

在資料來源下，提供資料來源的名稱。
從資料來源下拉式清單中選取 Confluence。
在來源下，輸入您的 Confluence URL （例如，https://example.atlassian.net)。
在身分驗證下，選取基本身分驗證或 OAuth 2.0 身分驗證。
選取或建立 AWS Secrets Manager 秘密以存放您的登入資料。
（選用，僅限基本身分驗證）若要啟用文件層級存取控制，請選取使用 ACLs 控制文件存取。您選取的秘密必須包含 adminApiKey、 organizationId和 directoryId。此選項無法在建立後變更。如需詳細資訊，請參閱文件層級存取控制。
（選用）展開同步範圍以選擇要爬取的實體類型（頁面、部落格、頁面附件、部落格附件、封存空間、封存頁面、個人空間）。
（選用）展開實體 URLs以使用 URL 型篩選來同步特定的 Confluence 空間、頁面和部落格。
（選用）展開 Mime 類型 regex 模式，以包含或排除特定 MIME 類型。

API

若要建立 Confluence 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 CreateDataSource 請求。下列 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是非同步的：當操作完成CREATINGAVAILABLE時，資料來源狀態會從轉換為。

連接器參數

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

aclEnabled 明確設定

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

connectionConfiguration
欄位	必要	描述
`secretArn`	是	包含 Confluence 登入資料的 AWS Secrets Manager 秘密 ARN。
`type`	是	Confluence 部署類型。設定為 `SAAS`。不支援 Confluence Server 和資料中心。
`authType`	是	驗證類型。將設定為 `BASIC`或 `OAUTH2`。請參閱身分驗證方法。
`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 組織管理員憑證的秘密。您無法在建立資料來源後變更此設定。如需詳細資訊，請參閱文件層級存取控制。

變更身分驗證方法

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

後續步驟

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

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

設定 OAuth 2.0 身分驗證

文件層級存取控制