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

# Confluence
<a name="kb-managed-ds-confluence"></a>

Atlassian Confluence 是一款协作式工作管理工具，用于共享、存储和处理文档和页面。您可以将 Confluence Cloud 实例作为托管知识库的数据源进行连接，以抓取页面、博客文章及其附件。仅支持 Confluence 云 (SaaS)；不支持 Confluence 服务器和数据中心。

## 支持的功能
<a name="kb-managed-supported-features-confluence"></a>
+ 跨空间抓取页面、博客文章及其附件
+ 自动检测常见文档字段（例如标题、作者以及创建或修改日期）
+ 空间、页面和博客的包含内容过滤器
+ 适用于 MIME 类型的包含或排除内容过滤器
+ 对已添加、更新和删除的内容进行增量内容同步
+ 基本身份验证和 OAuth 2.0 身份验证
+ Document-level 访问控制 (ACL)，使用基本身份验证和 Atlassian 组织管理员凭证

## 身份验证方法
<a name="kb-managed-confluence-auth-methods"></a>

Confluence 数据源支持两种身份验证方法。在开始之前选择一个，因为它决定了您创建的凭据以及您是否可以使用文档级别的访问控制。我们建议对新数据源进行基本身份验证。


**Confluence 身份验证方法**  

| 方法 | 它如何进行身份验证 | 何时使用 | 设置 | 
| --- | --- | --- | --- | 
| 基本 (BASIC)-推荐 | 连接器使用 Confluence 用户的电子邮件地址和 Atlassian API 令牌登录。 | 大多数数据源以及任何使用文档级访问控制的数据源。ACL 还需要使用同一个密钥中的 Atlassian 组织管理员证书。 | [设置基本身份验证](kb-managed-confluence-basic-setup.md) | 
| OAuth 2.0 () OAUTH2 | 连接器使用应用程序密钥、应用程序密钥、访问令牌和刷新令牌作为 Atlassian OAuth 2.0 (3LO) 应用程序进行身份验证。访问令牌会使用刷新令牌自动续订。 | 当您想要注册的 Atlassian 应用程序而不是个人用户帐户时使用。文档级访问控制不支持。 | [设置 OAuth 2.0 身份验证](kb-managed-confluence-oauth2-setup.md) | 

## 先决条件
<a name="kb-managed-prereqs-confluence"></a>

**在 Confluence 中，请确保**：
+ 记下你的 Confluence 云实例网址（例如，{{https://example.atlassian.net}}）。网址是以结尾的基本网址`.atlassian.net`。

**在您的 AWS 账户中，请确保**：
+ 将身份验证凭证存储在 [AWS Secrets Manager 密钥](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html)中，并记下该密钥的 Amazon 资源名称（ARN）。
+ 要在密钥中存储的确切键值对，请参阅您的身份验证方法的设置页面：[为 Confluence 设置基本身份验证](kb-managed-confluence-basic-setup.md)或。[为 Confluence 设置 OAuth 2.0 身份验证](kb-managed-confluence-oauth2-setup.md)
+ 在知识库的 AWS Identity and Access Management (IAM) role/permissions 策略中包含连接数据源的必要权限。有关所需权限的信息，请参阅[访问数据来源的权限](kb-permissions.md#kb-permissions-access-ds)。

## 如何设置 Confluence 数据源
<a name="kb-managed-confluence-workflow"></a>

设置 Confluence 数据源涉及以下步骤：

1. **设置身份验证。**按照您选择的方法页面在 Confluence 中创建凭证并将其存储在 AWS：[为 Confluence 设置基本身份验证](kb-managed-confluence-basic-setup.md)或。[为 Confluence 设置 OAuth 2.0 身份验证](kb-managed-confluence-oauth2-setup.md)

1. **Connect 数据源。**使用 AWS 管理控制台 或 API 在知识库中创建 Confluence 数据源。请参阅[连接 Confluence 数据源](kb-managed-ds-confluence-connect.md)。

1. **（可选）启用文档级访问控制。**按每位用户的 Confluence 权限筛选查询结果。需要使用 Atlassian 组织管理员凭据进行基本身份验证。请参阅[Document-level 访问控制](kb-managed-ds-confluence-acl.md)。