View a markdown version of this page

将 AWS 安全代理连接到 Confluence - AWS 安全代理
Confluence 集成的工作原理先决条件注册 Confluence 连接为代理空间选择页面排除 Confluence 集成后续步骤

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

将 AWS 安全代理连接到 Confluence

将您的 AWS 安全代理连接到 Confluence Cloud，为安全评估提供文档背景。与代码提供商不同，Confluence 充当文档来源，提供威胁模型、架构文档、API 规范和其他提高安全审查质量的材料。在开始之前，如何与代理空间进行集成请查看以了解如何在代理空间中重复使用注册。

Confluence 集成有多种用途：

  • 设计审查上下文-为安全设计审查提供架构文档和设计规范

  • 威胁建模-为威胁分析提供现有威胁模型和系统文档

  • 渗透测试上下文-提供应用程序文档，以便在渗透测试期间加深理解

将 Confluence 连接到 AWS 安全代理需要在您的 Atlassian 网站上安装 AWS 安全代理 Forge 应用程序并完成 OAuth 授权流程。

注意

AWS 安全代理仅支持 Confluence 云。不支持 Confluence 数据中心和 Confluence 服务器。

Confluence 集成的工作原理

Confluence 是文档提供商，而不是源代码提供商。在您安装 Forge 应用程序并连接 AWS 管理控制台中的空间或页面后，AWS 安全代理可以访问您的 Confluence 内容，以便在安全评估期间提供背景信息。

AWS Security Agent 会读取页面内容以了解您的应用程序架构、安全要求和设计决策。这种上下文提高了设计审查、代码审查和渗透测试期间安全发现的质量和相关性。

先决条件

在开始之前，请确保您满足以下条件：

  • 具有管理员访问权限的 Confluence Cloud 站点

  • 具有站点管理员权限的 Atlassian 帐户

  • 在 AWS 安全代理管理控制台中配置集成的权限

重要

一个 Atlassian 站点只能与每个区域的一个 AWS 账户关联。如果您需要将同一 Confluence 站点连接到同一区域内不同 AWS 账户中的 AWS 安全代理，则必须先移除现有集成。

注意

Atlassian Forge 应用程序的定价适用于此集成。有关更多信息，请参阅 Atlassian 文档中的 Forge 平台定价。

注册 Confluence 连接

  1. 在 AWS 安全代理管理控制台中，导航到 “集成”。

  2. 选择添加集成。

  3. 选择 Confluence，然后选择 “下一步”。

  4. 按照屏幕上的说明在您的 Atlassian 网站上安装 AWS Security Agent Forge 应用程序。安装完成后，复制安装 ID。请参阅找到你的 Atlassian 安装 ID。

  5. 例如，在 Confluence 网站网址字段中，输入您的网站网址。https://acme.atlassian.net

  6. 在 “安装 ID” 字段中，粘贴您从 Confluence 中复制的安装 ID。

  7. 选择授权。

    您将被重定向到 Atlassian，以授权 AWS 安全代理访问您的 Confluence 网站。授权完成后，您将返回控制台。

  8. 在注册详细信息部分，输入此连接的注册名称。有效字符包括字母、数字、句点、下划线和连字符。

  9. 选择连接。

为代理空间选择页面

注册 Confluence 集成后，将特定页面连接到代理空间。选择一个页面会授予 AWS 安全代理对该页面内容的读取（提取）权限。没有每页功能选项——代理会读取每个连接的页面。在连接向导的查看步骤中，您可以删除任何不希望代理访问的页面。

排除 Confluence 集成

如果您在 Confluence 集成过程中遇到问题，请使用以下指南来解决常见问题。

无法完成注册

如果注册过程中断，Forge 应用程序可能会安装在您的 Atlassian 网站上，但不会在 AWS 控制台中注册。

解决方案

  • 返回 AWS 安全代理控制台并重新启动集成过程。

  • Forge 应用程序仍处于安装状态，无需重新安装。

已从 Atlassian 中卸载 Forge 应用程序

如果已从您的 Atlassian 站点卸载 AWS 安全代理 Forge 应用程序，而 AWS 安全代理中仍存在该集成：

症状

  • 集成显示在 AWS 控制台中，但无法访问 Confluence 内容

  • 尝试列出或阅读页面时出错

解决方案

  • 从 Atlassian Marketplace 重新安装 Forge 应用程序

  • 如果问题仍然存在，请移除 AWS 控制台中的集成并重新注册

网站已连接到其他 AWS 账户

解决方案

  • 每个区域一个 Atlassian 站点只能连接到一个 AWS 账户。

  • 确定哪个 AWS 账户已有集成并使用该账户，或者先移除现有集成。

后续步骤

将 Confluence 连接到 AWS 安全代理后：

  • 导航到要使用此文档的代理空间

  • 选择要包含的特定页面作为设计审查和渗透测试的上下文

  • 如果需要，可通过 S3 上传其他文档（请参阅从 S3 存储桶中提供代理资源）