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

# エージェントスペースとの統合の仕組み
<a name="about-integrations"></a>

AWS セキュリティエージェントは、サードパーティーのソースコードおよびドキュメントプロバイダーに接続して、エージェントがセキュリティ評価中にコードとドキュメントを分析できるようにします。特定のプロバイダーを接続する前に、統合がエージェントスペースと機能にどのように関連しているかを理解するのに役立ちます。

## 一度登録すると、どこでも再利用できます
<a name="_register_once_reuse_everywhere"></a>

プロバイダーを AWS セキュリティエージェントに接続するには、異なるレベルで発生する 2 つの異なるステップが必要です。

1.  **統合 (アカウントレベル) を登録します。**AWS セキュリティエージェントマネジメントコンソール**の統合**ページからプロバイダーを 1 回登録します。登録は、GitHub 組織、GitLab グループ、Bitbucket ワークスペース、Confluence サイトなどのプロバイダーアカウントへの承認された接続を表します。登録はアカウントレベルのリソースです。

1.  **リソースをエージェントスペース (エージェントスペースレベル) に接続します。**エージェントスペース内から、ソースコードプロバイダーのリポジトリまたは Confluence のページなど、登録された統合からリソースを接続し、エージェントがリソースを使用する方法を設定します。このステップは、各エージェントスペースに固有です。

1 つの登録は、アカウント内のすべてのエージェントスペースで再利用されます。1 つのエージェントスペースの設定中にプロバイダーを登録した場合、リソースを別のエージェントスペースに接続するときに同じ登録を使用できます。同じプロバイダーを再度登録することはありません。

## 機能間で共有される 1 つの接続
<a name="_one_connection_shared_across_capabilities"></a>

リソースをエージェントスペースに接続すると、そのリソースはエージェントの機能間で共有されます。機能ごとにリポジトリを個別に接続することはありません。
+  **読み取りアクセスは、 リソースを接続することで付与されます。**リポジトリを接続すると、AWS セキュリティエージェントはそれをフルコードスキャン (コードレビュー）、ペネトレーションテストコンテキスト、脅威モデリング、設計レビューのために読み取ることができます。Confluence ページを接続すると、エージェントはそれを設計レビュー、脅威モデリング、侵入テストのドキュメントコンテキストとして読み取ることができます。
+  **書き込みアクションは、リポジトリごとにオプトインされます。**ソースコードリポジトリをエージェントスペースに接続すると、リポジトリごとに書き込みアクションをさらに有効にできます。
  +  **コードレビューコメント** - AWS セキュリティエージェントは、レビュー結果をプルリクエスト (または GitLab でのマージリクエスト) のコメントとして投稿します。
  +  **コード修復** - AWS セキュリティエージェントは、検出された脆弱性を修正してプルリクエスト (またはマージリクエスト) を開きます。

    これらの書き込みアクションは、パブリックリポジトリでは使用できません。読み取り専用分析は引き続き適用されます。

**注記**  
Confluence は、ソースコードプロバイダーではなくドキュメントプロバイダーです。AWS セキュリティエージェントは、接続された Confluence ページを読み取り、設計レビュー、脅威モデリング、侵入テストのコンテキストを提供します。ページを選択すると、読み取りアクセスが許可されます。ページごとの機能切り替えはありません。

## サポートされているプロバイダー
<a name="_supported_providers"></a>

AWS セキュリティエージェントは、次のプロバイダーをサポートしています。
+  **ソースコード** - GitHub (クラウドホスト GitHub およびクラウドホスト GitHub Enterprise)、GitHub Enterprise Server (セルフホスト）、GitLab (クラウドホスト）、GitLab Self-Managed (セルフホスト）、Bitbucket Cloud。
+  **ドキュメント** - Confluence Cloud。

パブリックインターネット経由で到達できないセルフホストプロバイダーの場合、プライベート接続を介してエージェントのトラフィックをルーティングできます。詳細については、「[プライベートにホストされたソースコントロールに接続する](connect-private-connection.md)」を参照してください。

## 次の手順
<a name="_next_steps"></a>
+ **統合**ページからプロバイダーを登録します。など、プロバイダーの接続トピックを参照してください[AWS セキュリティエージェントを GitHub リポジトリに接続する](connect-github.md)。
+ リソースをエージェントスペースに接続し、機能を設定します。「[コードレビューを有効にする](enable-code-review-scan.md)」および「[ペネトレーションテストを有効にする](enable-penetration-test.md)」を参照してください。