セットアップ: 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 が並んでいれば、初期セットアップは完了です。