翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS セキュリティエージェントを Confluence に接続する
<a name="connect-confluence"></a>

AWS セキュリティエージェントを Confluence Cloud に接続して、セキュリティ評価のドキュメントコンテキストを提供します。コードプロバイダーとは異なり、Confluence は、脅威モデル、アーキテクチャドキュメント、API 仕様、およびセキュリティレビューの品質を向上させるその他のマテリアルを提供するドキュメントソースとして機能します。開始する前に、[エージェントスペースとの統合の仕組み](about-integrations.md)「」を参照して、登録がエージェントスペース間でどのように再利用されるかを理解してください。

Confluence 統合には複数の目的があります。
+  **設計レビューコンテキスト** - セキュリティ設計レビュー用のアーキテクチャドキュメントと設計仕様を提供します。
+  **脅威モデリング** - 脅威分析用の既存の脅威モデルとシステムドキュメントを提供します。
+  **侵入テストコンテキスト** - 侵入テスト中により深く理解するためのアプリケーションドキュメントを提供します

Confluence を AWS セキュリティエージェントに接続するには、Atlassian サイトに AWS Security Agent Forge アプリをインストールし、OAuth 認可フローを完了する必要があります。

**注記**  
AWS セキュリティエージェントは Confluence Cloud のみをサポートします。Confluence データセンターと Confluence Server はサポートされていません。

## Confluence 統合の仕組み
<a name="_how_confluence_integration_works"></a>

Confluence は、ソースコード**プロバイダー**ではなくドキュメントプロバイダーです。Forge アプリをインストールし、AWS マネジメントコンソールでスペースまたはページを接続すると、AWS セキュリティエージェントは Confluence コンテンツにアクセスして、セキュリティ評価中にコンテキストを提供できます。

AWS Security Agent は、ページコンテンツを読み取り、アプリケーションアーキテクチャ、セキュリティ要件、設計上の決定を理解します。このコンテキストにより、設計レビュー、コードレビュー、侵入テスト中のセキュリティ検出結果の品質と関連性が向上します。

## 前提条件
<a name="_prerequisites"></a>

開始する前に、以下があることを確認してください。
+ 管理者アクセス権を持つ Confluence Cloud サイト
+ サイト管理者権限を持つ Atlassian アカウント
+ AWS Security Agent Management Console で統合を設定するアクセス許可

**重要**  
1 つのアトラシアンサイトは、リージョンごとに 1 つの AWS アカウントにのみ関連付けることができます。同じ Confluence サイトを同じリージョン内の別の AWS アカウントの AWS セキュリティエージェントに接続する必要がある場合は、まず既存の統合を削除する必要があります。

**注記**  
Atlassian Forge アプリの料金がこの統合に適用されます。詳細については、Atlassian ドキュメントの「[Forge platform pricing](https://developer.atlassian.com/platform/forge/forge-platform-pricing/)」を参照してください。

## Confluence 接続を登録する
<a name="_register_a_confluence_connection"></a>

1. AWS セキュリティエージェントマネジメントコンソールで、**統合**に移動します。

1. [**Add integration**] (統合の追加) を選択します。

1. **Confluence** を選択し、次**へ**を選択します。

1. 画面の指示に従って、AWS Security Agent Forge アプリを Atlassian サイトにインストールします。インストール後、インストール ID をコピーします。「[Atlassian インストール ID を検索する](find-atlassian-installation-id.md)」を参照してください。

1. **Confluence サイト URL** フィールドに、 などのサイト URL を入力します`https://acme.atlassian.net`。

1. **Installation ID** フィールドに、Confluence からコピーしたインストール ID を貼り付けます。

1. [**承認**] を選択します。

   Atlassian にリダイレクトされ、AWS セキュリティエージェントが Confluence サイトにアクセスすることを許可します。認可が完了したら、コンソールに戻ります。

1. **登録の詳細** セクションに、この接続**の登録名**を入力します。有効な文字は、文字、数字、ピリオド、アンダースコア、ハイフンです。

1. **接続** を選択します。

## エージェントスペースのページを選択する
<a name="_select_pages_for_an_agent_space"></a>

Confluence 統合を登録したら、特定のページをエージェントスペースに接続します。ページを選択すると、そのページのコンテンツへの読み取り (フェッチ) アクセスが AWS セキュリティエージェントに付与されます。ページごとの機能オプションはありません。エージェントは接続されたすべてのページを読み込みます。接続ウィザードのレビューステップでは、エージェントにアクセスさせたくないページを削除できます。

## Confluence 統合のトラブルシューティング
<a name="_troubleshoot_confluence_integration"></a>

Confluence 統合プロセス中に問題が発生した場合は、次のガイダンスを使用して一般的な問題を解決します。

### 登録を完了できません
<a name="_unable_to_complete_registration"></a>

登録プロセスが中断された場合、Forge アプリは Atlassian サイトにインストールされているが、AWS コンソールに登録されていない可能性があります。

#### 解像度
<a name="_resolution"></a>
+ AWS セキュリティエージェントコンソールに戻り、統合プロセスを再起動します。
+ Forge アプリはインストールされたままであり、再インストールする必要はありません。

### Atlassian からアンインストールされた Forge アプリ
<a name="_forge_app_uninstalled_from_atlassian"></a>

統合が AWS セキュリティエージェントにまだ存在する間に、AWS Security Agent Forge アプリが Atlassian サイトからアンインストールされた場合:

#### 症状
<a name="_symptoms"></a>
+ 統合は AWS コンソールに表示されますが、Confluence コンテンツにアクセスできません
+ ページを一覧表示または読み込もうとしたときのエラー

#### 解像度
<a name="_resolution_2"></a>
+ Atlassian Marketplace から Forge アプリを再インストールする
+ 問題が解決しない場合は、AWS コンソールで統合を削除し、再登録します。

### サイトが既に別の AWS アカウントに接続されている
<a name="_site_already_connected_to_another_aws_account"></a>

#### 解像度
<a name="_resolution_3"></a>
+ 1 つの Atlassian サイトは、リージョンごとに 1 つの AWS アカウントにのみ接続できます。
+ 既存の統合がある AWS アカウントを特定し、そのアカウントを使用するか、最初に既存の統合を削除します。

## 次の手順
<a name="_next_steps"></a>

Confluence を AWS セキュリティエージェントに接続した後:
+ このドキュメントを使用するエージェントスペースに移動します。
+ 設計レビューと侵入テストのコンテキストとして含める特定のページを選択する
+ 必要に応じて S3 経由で追加のドキュメントをアップロードする (「」を参照[S3 バケットからエージェントリソースを提供する](enable-s3-bucket.md))