参考: 組織セキュリティ要件(Security requirements)の追加
ここまでのフェーズではAWS Security Agentが内蔵するセキュリティチェック(一般的な脆弱性・OWASP Top 10)を中心に体験してきました。Security Agentはさらに、組織固有のセキュリティポリシーをカスタム要件として定義し、設計レビュー・コードレビューで自動チェックさせることができます。本章は任意の発展課題として、その挙動を体験できる構成です。
1. セキュリティ要件(Security requirements)とは
セキュリティ要件は 組織レベル で定義され、全エージェントスペース共通で適用 されます。「使ってよいライブラリ」「ログ出力ルール」「DB接続方式」など、業務ドメインや組織のコーディング規約に合わせた独自ルールを言葉で記述しておくと、AIがレビュー時にそれらへの準拠性も判定してくれます。
2. セキュリティ要件の登録
組織独自のルールをAIに守ってもらうには、まずルール自体をSecurity Agentに登録する必要があります。本章では、Tasks API で問題になっていた「f-string で組み立てる生SQL」を構造的に防ぐため、「DBアクセスはORM経由に限定する」というルールを1件登録します。Security Agent コンソールの左メニューから「セキュリティ要件」ページを開き、「カスタムセキュリティ要件」タブに切り替えて、画面右側の「カスタムセキュリティ要件を作成」をクリックします。タブには他に「マネージドセキュリティ要件」(AWSが提供するテンプレート一覧)と「有効なセキュリティ要件」(現在有効化されているもの)がありますが、組織独自の要件を一から定義する場合は「カスタムセキュリティ要件」タブを使います。
登録画面では、上部に「AWS マネージドセキュリティ要件をカスタマイズ - オプション」セクションがあります。AWSが用意するテンプレートを出発点にしたいときはここでテンプレートを選択しますが、本章では一から定義するため未選択のまま進めます。その下の「セキュリティ要件の詳細」セクションに値を入力していきます。
ハンズオンでは、Tasks APIで露呈した f-string で組み立てた cursor.execute 起因のSQLインジェクション を構造的に防ぐ目的で、データベースアクセスを SQLAlchemy などのORM経由に限定する 生SQL禁止 の要件を1つ登録します。以下の値を入力し、画面右下の「セキュリティ要件の作成と有効化」ボタンで保存することで、作成と同時にレビュー対象として有効化できます(左隣の「セキュリティ要件を作成」は作成のみで有効化はしないボタンです)。
| 入力項目 | 何を指定するか | 値 |
|---|---|---|
| セキュリティ要件名 | 要件の識別名(80文字以内) | ORM-only database access |
| 説明 | 要件がチェックする内容の簡潔な説明(500文字以内) | データベースアクセスは必ずSQLAlchemyを経由し、生SQLの実行(cursor.execute 等)を禁止する。 |
| 適用性 | この要件を評価すべきシナリオ・システムタイプ・条件(10,000文字以内) | データベースに対するすべてのCRUD操作。ユーザ管理・タスク管理・認証情報の検証・管理者機能などのDB操作を含む。 |
| コンプライアンス条件 | 何を「遵守」とし、何を「違反」とするかの判定基準(10,000文字以内) | 遵守: SQLAlchemy ORM(db.query()、db.add() など)またはORMの text() ヘルパーとパラメータ化クエリでDBアクセスしている。違反: cursor.execute(f"SELECT ...") のように生SQLを文字列で組み立てている、f-string や + でユーザ入力をSQL文に埋め込んでいる。 |
| 是正ガイダンス - オプション | 違反を検出したときの修正方法ガイダンス(10,000文字以内)。組織内のコーディング規約ドキュメントへのリンクなどを記載する | SQLAlchemy ORMに移行し、User.query.filter_by(email=email).first() のようなORMクエリで書く。生SQLが必要な場合は text(...) とパラメータバインドを使用する。 |
保存後、「カスタムセキュリティ要件」タブの一覧に ORM-only database access が表示され、「セキュリティ要件のステータス」列が 「有効化済み」 になっていれば登録完了です。
実際には認証ライブラリの統一・構造化ログによるPII保護など複数の要件を組み合わせて運用しますが、本章では挙動の確認が目的のため、この1件で十分です。
3. コードレビュー設定の切り替え
セキュリティ要件を登録しただけでは、コードレビューはそれを評価対象としてくれません。フェーズ2でコードレビュー設定を「セキュリティ脆弱性検出結果」のみで作成しているため、登録した組織要件もレビュー対象に含めるには、エージェントスペースのコードレビュー設定を切り替える必要があります。
エージェントスペース fastapi-sample-app の詳細画面を開き、「コードレビュー」タブ に切り替えます。「コードレビュー設定」セクションの右上にある 「設定を編集」 ボタンをクリックします。
「コードレビュー設定を編集」モーダルが開き、3つの選択肢が表示されます。「セキュリティ要件と脆弱性検出結果」 を選択して 「変更を保存」 をクリックします。
「コードレビュー設定」セクションの 「選択」 が「セキュリティ要件と脆弱性検出結果」に変わっていれば、設定変更は完了です。これで、以降に作成されるPRから組織要件への準拠性チェックも追加で行われるようになります。
4. 期待される挙動の変化
設定を切り替えたあとに新しくPRを作成すると、Tasks APIに対するコードレビューでは、通常の脆弱性検出に加えて 組織要件への準拠性チェック が動きます。今回登録した要件であれば、app/main.py の cursor.execute による生SQL実行が「ORM-only database access に違反」として、組織要件側の指摘として現れる、という挙動になります。
| 💡 ポイント |
|---|
| 本章では コードレビューの再実行は行いません。コードレビューにはプレビュー期間中の無料クォータ上限があり、検証のために何度もPRを作り直すと上限に達する可能性があるためです。コードレビュー自体の挙動はフェーズ2で確認済みなので、ここでは「設定を切り替えると次回PR以降のレビュー結果がこう変わる」という理解までで十分です。実際のプロジェクトで試したくなったタイミングで、必要なPRに対して1度だけ走らせるのがおすすめです。 |
このように、組織独自のコーディング規約を コードレビューに自動で組み込める ことが、Security Agentを運用する際の大きなメリットになります。認証ライブラリの統一やPII保護など、組織のセキュリティポリシーに合わせて要件を増やしていくことで、AIレビューが守るべきルール集をそのまま組織のガードレールにできます。
| 💡 ポイント |
|---|
| 組織セキュリティ要件は、ハンズオン後の片付けで削除しなくても課金には影響しません(設計レビュー・コードレビューは無料クォータ内で利用できるため)。本番運用に向けて要件をブラッシュアップしていく場合は、そのまま残して継続的に育てていくのがおすすめです。 |