フェーズ2: コードレビューの体験
フェーズ1では、設計段階でセキュリティ要件への違反を見つける設計レビューを体験しました。ただし、設計書だけでは「どんなコードを書くか」までは見えません。たとえばSQL文字列の組み立て方やパスワードハッシュの選び方など、コードを書いてみないと判明しない問題 は、コミットされたコードに対してレビューする必要があります。
フェーズ2では、GitHubリポジトリを Security Agent と連携し、プルリクエストに対してAIが自動でコードレビューを行う流れをEnable code review capability for a GitHub repositoryの手順に沿って体験します。
1. Privateリポジトリの準備
コードレビューはPrivateリポジトリのみが対象のため(公式仕様)、まず事前準備でダウンロードしたコードをPrivateリポジトリにpushします。
| 💡 ポイント |
|---|
| 事前準備でダウンロードしたコードには 意図的な脆弱性 が含まれます。Publicリポジトリで作成すると第三者から攻撃手段の参考にされる、フォーク先で稼働させて攻撃される、などのリスクがあります。Visibilityは必ずPrivateを選択 してください。 |
GitHubで新規リポジトリを作成します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| Repository name | tasks-api-handson |
識別しやすい名前にする |
| Visibility | Private(必須) | 意図的な脆弱性を含むコードを公開しないため、またコードレビューがPrivateリポジトリ限定のため |
作成後、ローカルにクローンします。
以下のコマンドで、Git がインストールされていることを確認します。
git --version
以下のように Git のバージョンが表示されれば、インストールは確認できています。
git version 2.x.x
バージョンが表示されない場合は、Git/GitHubのセットアップ を先に実施してください。
インストールが確認できたら、リポジトリをローカルにクローンします。
git clone https://github.com/<あなたのユーザ名>/tasks-api-handson.git
cd tasks-api-handson
事前準備でzipを展開した tasks-api-source/ の中身(design-doc.md と app/)を作業ディレクトリにコピーします。フェーズ2でレビュー対象になるのは app/main.py のコードですが、design-doc.md もフェーズ3のペネトレーションテスト時に ソースコードのコンテキスト として参照されるため、ここで一緒にpushしておきます。
cp -r <zip展開先>/tasks-api-source/* .
リポジトリにpushします。
git add .
git commit -m "Add initial Tasks API"
git push origin main
GitHubの該当リポジトリで design-doc.md、app/main.py、app/__init__.py がmainブランチに表示されていれば、Privateリポジトリの準備は完了です。
| 💡 ポイント |
|---|
| ここで push したコードと 同じ内容のFastAPIアプリケーション が、フェーズ3でCloudFormationテンプレートのUserDataに埋め込まれてEC2上で起動します(リポジトリのコードと稼働環境のコードは1対1対応)。Security Agentはペネトレーションテスト時にこのPrivateリポジトリ側のソースコードを コンテキスト として参照するため、設計→コード→稼働環境を横断した分析が成立します。 |
2. GitHub統合の登録(テナントレベル)
コードレビューを動かすには、Security Agent と GitHub を信頼関係で結ぶ必要があります。Security Agent側に「どのGitHub組織・ユーザのリポジトリを見るか」、GitHub側に「Security Agent App にどんな権限を渡すか」を双方向で登録するのがこのフェーズです。テナント(AWSアカウント)レベルの一度きりの設定なので、ここで登録しておけば以降のエージェントスペースから再利用できます。
2.1 統合の追加モーダルを開く
GitHub統合の登録は、エージェントスペース詳細画面の「コードレビューを有効にする」を起点に進めるフローになっています。エージェントスペース詳細画面のコードレビューカードにある 「コードレビューを有効にする」 をクリックします。
「統合を追加」 モーダルが開きます。初回は登録済みのGitHub統合がないため、右側の 「新規登録を作成」 を選択し、下の GitHub を選択して 「次へ」 をクリックします。
「GitHub を AWS Security Agent に接続」 画面が開きます。この画面は ステップ1(GitHub App のインストール) / ステップ2(AWS Security Agent の認証) / ステップ3(登録の詳細) の3部構成になっており、上から順に進めます。
2.2 ステップ1: GitHub App のインストール
GitHub側に「Security Agent App」を入れることで、Security Agent が GitHub のリポジトリやPRを操作できるようになります。これがないとSecurity Agent側から GitHub にコメントを書き込んだり、PRを生成したりできません。ステップ1 の「GitHub で AWS Security Agent を開く」をクリックすると、GitHub の AWS Security Agent App ページが開きます。右上の 「Install」 をクリックします。
インストール範囲の選択画面になります。本章では自分のアカウント配下の tasks-api-handson リポジトリだけが対象なので、「All repositories」 のままで問題ありません(「Only select repositories」で tasks-api-handson のみ指定してもOK)。「Install」 をクリックします。
2.3 ステップ2: AWS Security Agent の認証
ステップ1 はGitHub側のAppインストールだけなので、次はAWS側に「このGitHubユーザとして連携してよい」という認証情報を渡します。これがAWS↔GitHub の双方向トラスト関係を完成させるステップです。AWS Security Agent の画面に戻ります。次に ステップ2 の 「認証する」 をクリックします。
GitHub の認可画面にリダイレクトされます。AWS Security Agent が GitHub アカウントへアクセスする権限を確認し、「Authorize」 をクリックします。
AWS Security Agent の画面に戻ると、ステップ2に 「認証が成功しました」 のチェックマークが表示されます。
2.4 ステップ3: 登録の詳細を入力
最後にAWS側でこの統合を識別する名前と、対象とするGitHubアカウントタイプを登録します。これでテナント(AWSアカウント)レベルのGitHub統合の登録自体は完了します。ステップ3 の登録の詳細を入力します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| 登録名 | tasks-api-handson |
複数のGitHub組織を登録する場合の識別名 |
| GitHub アカウントタイプ | ユーザ |
個人アカウントの場合。組織アカウントなら「組織」を選択 |
入力後、右下の 「接続」 をクリックします。
エージェントスペース画面に遷移し、上部に緑のバナー 「GitHub 統合が正常に接続されました」 が表示されれば、テナントレベルのGitHub統合登録は完了です。
3. エージェントスペースへのリポジトリ接続とコードレビュー有効化
ここからはエージェントスペースレベルの操作で、実際に監視対象となるリポジトリを fastapi-sample-app エージェントスペースに紐付けます。
3.1 統合追加モーダルから既存の登録を選択する
テナントレベルのGitHub統合を登録しただけでは、どのエージェントスペースから・どのリポジトリを 監視するかが決まっていません。同じモーダルからもう一度フローを開始し、今度は登録済みのGitHub統合を再利用してエージェントスペースに紐付けていきます。エージェントスペース詳細画面に戻ったら、コードレビューカードの 「コードレビューを有効にする」 を再度クリックします。
再び 「統合を追加」 モーダルが開きますが、今度は前項で登録したGitHub統合が 「利用可能な登録」 に表示されています。tasks-api-handson を選択して 「次へ」 をクリックします。
3.2 監視対象リポジトリを選択する
GitHub統合は組織やユーザ全体への接続なので、その配下に複数のリポジトリがある場合は、どれをこのエージェントスペースで監視するか を明示的に選ぶ必要があります。本章の対象は1つだけなので、それだけにチェックを入れます。「GitHub リポジトリを接続」 画面で、登録済み組織配下のリポジトリ一覧が表示されます。本章の対象である tasks-api-handson にチェックを入れて 「次へ」 をクリックします。
3.3 機能を有効化する
「機能を管理」 画面で、接続したリポジトリに対して有効にする機能を設定します。リポジトリ列のチェックを入れただけでは機能はONになりません。コードレビュー列とペネトレーションテストの修正列のトグルを、それぞれクリックして「有効化済み」に切り替える 必要があります。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| リポジトリ列のチェック | ✅ tasks-api-handson |
このエージェントスペースに紐付ける対象 |
| コードレビュー列のトグル | 有効化済み(クリックしてONにする) | PRごとの自動レビューを有効化 |
| ペネトレーションテストの修正列のトグル | 有効化済み(クリックしてONにする) | フェーズ3の修正PR自動生成でも使うため、ここで有効化しておく |
3.4 コードレビュー設定で検出対象を選ぶ
コードレビューでは「汎用的な脆弱性パターンを検出する」「組織独自のセキュリティ要件への準拠性をチェックする」「両方」のいずれかを選べます。本章ではフェーズ2で組織要件をまだ登録していないため、まずは汎用的な脆弱性検出のみを選び、AIが何を指摘してくれるかを体験します。次に 「コードレビュー設定」 で検出対象を選択します。
| オプション | 内容 | 本章の選択 |
|---|---|---|
| セキュリティ要件の検証 | 組織のカスタムセキュリティ要件のみチェック | |
| セキュリティ脆弱性検出結果 | 一般的な脆弱性(SQLi等)のみ検出 | ✅ 選択 |
| セキュリティ要件と脆弱性検出結果 | 組織のカスタムセキュリティ要件と一般的なセキュリティ脆弱性の両方について確認 |
右下の 「接続」 をクリックします。
3.5 接続完了を確認する
設定が一通り終わっても、本当にエージェントスペースとリポジトリが正しく紐付けられているかを画面で確認しないと、後でPRを作っても「レビューが走らない」という事態に気付くのが遅れます。コードレビュータブの状態を確認することで、ここで連携の成立を確実にしておきます。エージェントスペース画面に戻り、上部に緑のバナー 「統合リソースが追加されました」 が表示されます。さらに 「コードレビュー」タブ を開き、tasks-api-handson が一覧に並んでいればコードレビューの有効化は完了です。
| ⚠️ タブに「リポジトリはまだ接続されていません」と出る場合 |
|---|
| まず 「機能を管理」画面で「コードレビュー」列と「ペネトレーションテストの修正」列のトグルが両方とも「有効化済み」になっているか を確認してください。リポジトリ列のチェックを入れても、これらのトグルがOFFのまま「接続」してしまうと、緑バナー 「統合リソースが追加されました」 は表示されますが、コードレビュータブには反映されません。タブ内の 「コードレビューを有効にする」 ボタンから再度フローを進め、トグルをONにしてから「接続」してください。トグルはONで接続済みなのに表示が変わらない場合は、UIの反映遅延の可能性があるため ブラウザをリロード すれば解消します。 |
4. 脆弱なコードのPR作成
ここまでの設定でコードレビューは有効になりましたが、レビューを動かす対象がまだありません。コードレビューが動くのはプルリクエストが作られた瞬間なので、わざと脆弱性を含んだPRを作って、AIが何を指摘してくれるかを確認します。
先ほどpushした app/main.py に、新しい脆弱なエンドポイント(タスク検索機能)を追加するPRを作成します。
ローカルでリポジトリを開き、ブランチを作成します。
git switch -c add-task-search
app/main.py の末尾(admin_list_users の関数定義の直後)に、以下のコードを追加します。
@app.get("/api/v1/tasks/search")
def search_tasks(q: str):
conn = get_db()
c = conn.cursor()
c.execute(
f"SELECT id, owner_id, title, body FROM tasks WHERE title LIKE '%{q}%'"
)
rows = c.fetchall()
conn.close()
return [
{"id": r[0], "owner_id": r[1], "title": r[2], "body": r[3]}
for r in rows
]
わざと以下の問題を埋め込んでいます。
- f-stringでクエリパラメータを直接SQL文に埋め込んでおり、SQLインジェクションが成立する
- 認証チェックがなく、全タスク(他ユーザのタスク含む)が誰でも検索可能になる
コードをコミットしてプルリクエストを作成します。
git add app/main.py
git commit -m "Add task search endpoint"
git push origin add-task-search
GitHubのリポジトリ画面を開くと、push直後は上部に 「Compare & pull request」 ボタンが表示されています。このボタンから、ベースブランチ main、比較ブランチ add-task-search の構成でプルリクエストを作成します。タイトルはコミットメッセージと同じ Add task search endpoint のままで構いません。
5. AIレビューコメントの確認
PR を作成したら、あとは AWS Security Agent が自動でレビューしてくれるのを待つだけです。普段のGitHubワークフローを離れずにAIレビューを受け取れるのが、コードレビュー機能の使い勝手の良さです。
PR を作成すると、ほぼ即時に aws-security-agent Bot から「AWS Security Agent is reviewing your pull request and will post feedback shortly.」というコメントが付き、レビューが開始されたことが分かります。
数分待つと、Bot が PR の解析を終え、全体の要約コメント と、追加した行に対するインラインコメント が投稿されます。
要約コメントでは、search_tasks エンドポイントに対する指摘が一括で提示されます。今回追加したコードに対しては、認証の欠如、owner_id での所有者スコープ不在による情報漏えい、f-string を使った SQL インジェクション の3点が、修正の方向性(get_current_user の呼び出し、WHERE owner_id = ? でのスコープ、パラメタライズドクエリ化)と合わせて指摘されます。
さらに該当行へのインラインコメントは、以下の3つの観点で構造化されています。
- What is the issue?: 何が問題か(コードのどの部分が脆弱か)
- Why is this important?: なぜ重要か(攻撃者に実際に何ができるか)
- What is the recommendation?: どう直すべきか(修正コード例つき)
PR上に要約コメントとインラインコメントが投稿され、SQLインジェクション・認証欠如・情報漏えいの3点に対して修正コード例つきの指摘が並んでいれば、コードレビューの体験は完了です。
| 💡 ポイント |
|---|
| AIが提案するコード修正例は、そのままコピペで使うのではなく必ずレビュアーが内容を確認してから反映してください。AIが誤った修正を提案する可能性もゼロではないため、最終判断は人間が行う前提で使います。 |