如何解决 Confluence Cloud 实例和我的 Amazon Bedrock 知识库之间的连接问题？

解决方法

在配置或数据摄取过程中，您可能会收到以下连接错误消息：

"There was an issue when connecting to your data source. Please check your data source credentials in Secrets Manager to ensure they are correct and provide the necessary permissions."

检查您的 Confluence Cloud 实例 URL

当您将 Confluence 实例连接到 Amazon Bedrock 时，请确保您的 Confluence 实例 URL 正确无误。Amazon Bedrock 仅支持以 .atlassian.net 结尾的 Confluence URL。Amazon Bedrock 不支持自定义域。

正确配置您的身份验证方法

Amazon Bedrock 支持 Confluence Cloud 连接的基本和 OAuth 2.0 身份验证类型。

基本身份验证

要设置基本身份验证，请创建 API 令牌。有关详细信息，请参阅 Atlassian 网站上的 Manage API tokens for your Atlassian account（管理您的 Atlassian 账户的 API 令牌）。

**注意：**默认情况下，Atlassian API 令牌在 1 年后到期。

然后，创建 AWS Secrets Manager 密钥来存储您的凭证。

OAuth 2.0 身份验证

要配置 OAuth 2.0，请参阅 Atlassian 网站上 Confluence 的 OAuth 2.0 配置。

然后，创建 Secrets Manager 密钥来存储以下凭证：

• confluenceAppKey
• confluenceAppSecret
• confluenceAccessToken
• confluenceRefreshToken

检查您的 IAM 角色权限

附加一项策略，为您与知识库关联的 AWS Identity and Access Management (IAM) 角色提供访问您的 Confluence 数据来源的权限。

确认密钥可以访问 Amazon Bedrock

完成以下步骤：

1. 打开 Secrets Manager 控制台。
2. 选择密钥。
3. 确认 Amazon 资源名称 (ARN) 的格式为 arn:aws:secretsmanager:REGION:account-id:secret:amazonbedrock-name。
   **注意：**将 REGION 替换为您的 AWS 区域，将 account-id 替换为您的 AWS 账户 ID，将 name 替换为您的密钥名称。

测试 API 令牌访问权限

要测试令牌访问权限，请从 Amazon Elastic Compute Cloud (Amazon EC2) 实例运行以下 curl 命令：

curl -v https://yourcompany.atlassian.net --user your-email@example.com:your-api-token

**注意：**将 yourcompany 替换为您的公司名称，将 your-email@example.com 替换为您的公司电子邮件，将 your-api-token 替换为您的 API 令牌。如果您与 AWS Support 共享输出，请将 your-api-token 替换为 REDACTED。

如果 curl 命令成功，则 200 OK HTTP 状态代码位于响应标头中，响应正文中有来自 Confluence 实例的内容。此外，没有"401 Unauthorized"错误消息或连接超时。

移除 Confluence 中的 IP 允许列表

Amazon Bedrock 不支持 IP 允许列表或 VPN。如果您在 Confluence 中添加了 IP 允许列表，请将其移除，以免网络连接失败。

如果您的网络设置需要 IP 允许列表，请使用 Amazon Bedrock 提供的网络爬网程序。

有关如何保持知识库安全的信息，请参阅 Amazon Bedrock 中的安全性。

配置日志目标以监控问题

要监控和解决摄取问题，请将 Amazon CloudWatch Logs 或 Amazon S3 设置为日志目标。