本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 连接 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 数据中心设置基本或 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`）。如果 REST API 是在 Web 根目录下提供的，则将其留空。

1. （可选，仅限 HTTPS）在 ** TLS 证书下**，为您的 Confluence 数据中心实例提供 TLS 证书的 Amazon S3 URI。

1. 在 “**身份验证” 下**，选择 “**基本身份验证” ** 或 “**个人访问令牌”**，然后选择保存匹配凭据的 AWS Secrets Manager 密钥。

1. （可选）扩展**同步范围**以选择要抓取的实体类型（页面、页面附件、博客、博客附件、个人空间）。

1. （可选）扩展**实体 URL ** 以使用 URL-based 筛选来同步特定的 Confluence 空间、页面和博客。

1. （可选）扩展 ** MIME 类型**以包括或排除特定的 MIME 类型。

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

要创建 Confluence 数据中心数据源，请使用 Agents for 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）。如果 REST API 是在 Web 根目录下提供的，则将其省略。 | 
| certificateS3Path | 否 | 您的 Confluence 数据中心实例的 TLS 证书的位置，在您通过 HTTPS 进行连接时使用。包含s3BucketName和s3KeyName。 | 


**数据EntityConfiguration （可选）**  

| 字段 | 必填 | 说明 | 
| --- | --- | --- | 
| crawlPage | 否 | 是否抓取页面。 | 
| crawlBlog | 否 | 是否抓取博客文章。 | 
| crawlPageAttachment | 否 | 是否抓取页面附件。只有当也crawlPagetrue是，才会爬行。 | 
| crawlBlogAttachment | 否 | 是否抓取博客文章附件。只有当也crawlBlogtrue是，才会爬行。 | 
| crawlPersonalSpace | 否 | 是否爬行个人空间。 | 

**注意**  
与 Confluence Cloud 不同，Confluence 数据中心不支持抓取存档空间或存档页面。


**过滤器配置（可选）**  

| 字段 | 必填 | 说明 | 
| --- | --- | --- | 
| inclusionSpaceUrls | 否 | 要包含的空格 URL。 | 
| inclusionPageUrls | 否 | 要包含的页面网址。 | 
| inclusionMimeTypes | 否 | 要包括的 MIME 类型。 | 
| exclusionMimeTypes | 否 | 要排除的 MIME 类型。 | 
| maxFileSizeInMegaBytes | 否 | 连接器接收的任何单个文件的最大大小（以兆字节为单位）。以数字字符串形式提供（例如，"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`和包含匹配凭据的密钥更新数据源，从而更改数据源的身份验证方法（例如，从 Basic 到个人访问令牌） AWS 管理控制台。

## 后续步骤
<a name="kb-managed-ds-confluence-onprem-connect-next"></a>

创建数据源后，将其同步以将内容摄取到您的知识库中。有关详细信息，请参阅[同步数据来源](kb-managed-sync.md)。