セットアップ: AWS Security Agentの初期セットアップ

AWS Security Agent は、最初に 1回だけ必要なアカウントレベルのセットアップ を行い、同時に最初の エージェントスペース(アプリケーション単位のワークスペース)を作成します。AWS公式の Set up AWS Security Agentに準拠した手順で進めます。

1. リージョンの確認

AWS Security Agent は提供リージョンが限られているため、まず最初に作業リージョンを正しく選んでおかないと、後でサービス画面が表示されなかったり、別リージョンに重複セットアップしてしまうトラブルにつながります。AWS Security Agent は、東京・バージニア北部・オレゴン・アイルランド・フランクフルト・シドニーの6リージョンで利用可能です。本章では、他のハンズオンと統一するため 東京リージョン (ap-northeast-1)で進めます。マネジメントコンソール右上のリージョンセレクタから アジアパシフィック(東京) ap-northeast-1 を選択してください。

2. Security Agentコンソールを開く

エージェントスペースの作成・管理は専用のコンソールから行うため、まずSecurity Agent画面を開きます。検索バーに Security Agent と入力し、AWS Security Agent のサービス画面を開きます。AWS Security Agent のランディングページが表示されたら、右側の 「AWS Security Agent をセットアップ」 をクリックします。

3. セットアップ画面の設定

セットアップ画面は1つのフォームに エージェントスペース設定 / ユーザアクセス設定 / サービスアクセス・Encryption・タグ(折りたたみ) が並んだ構成になっています。本章で設定するのは前半の2つで、後半のオプションはすべてデフォルトのままで構いません。

まず エージェントスペース設定 を入力します。エージェントスペースはアプリケーション・プロジェクト単位のワークスペースで、連携する GitHub リポジトリ・過去の設計レビュー・ペネトレーションテスト設定・検出結果がひとまとめに管理されます。

設定項目 値 設定の基準
エージェントスペース名 fastapi-sample-app 対象アプリケーションを識別できる名前(Webアプリケーション側に表示される)
説明 - オプション FastAPIサンプルアプリケーションのセキュリティレビュー用 エージェントスペースの用途が後から分かる記述

次に ユーザアクセス設定 で、ウェブアプリケーションへのアクセス方法を選択します。

  • 「IAM アイデンティティセンターによるシングルサインオン (SSO)」は IAM Identity Center 統合による SSO で、複数人のチーム運用に向いている
  • 「IAM 専用アクセス」は AWS マネジメントコンソール経由でのアクセスのみで、簡易セットアップに向いている

本章では 「IAM 専用アクセス」 を選択します。

📝 IAM 専用アクセス → IAM アイデンティティセンター の切り替え
画面上の黄色い注意ボックスにも記載のとおり、初期セットアップ後に「IAM 専用アクセス」から「IAM アイデンティティセンター」へ切り替えるには、AWS Security Agent のセットアップを一度削除して再作成する必要 があります。本番で複数人運用を想定するなら最初から IAM アイデンティティセンターを選ぶのが安全です(公式ドキュメント)。

残りの サービスアクセス・Encryption・タグ は折りたたまれているセクションで、本章では展開せずデフォルトのままで構いません。サービスアクセスは未設定のまま進めると、AWS Security Agent が必要な権限を持つ IAM ロールを自動作成してくれます。

設定が終わったら、画面右下の 「AWS Security Agent をセットアップ」 をクリックします。

4. セットアップの完了

クリックすると AWS Security Agent がエージェントスペースと Web Application、必要な IAM リソースを作成し、エージェントスペース一覧画面に遷移します。

画面上部に緑色の通知 「アプリケーションが正常に有効化されました。ようこそ!」 が表示され、一覧に fastapi-sample-app が並んでいれば、初期セットアップは完了です。