目次
Amazon Bedrock AgentCore Gateway のインターセプターは、Amazon Bedrock Guardrails を呼び出すことで、MCP ツールの引数と結果に含まれる日本のマイナンバーをマスキングできます。提示されたテストでは、インターセプターに障害が発生すると、マスキングされていない番号を返すことなく、リクエストまたはレスポンスが停止しました。
要点#
- モデル呼び出しに設定した Guardrails は、ツールの引数、結果、定義を検査しません。
- Gateway の REQUEST インターセプターと RESPONSE インターセプターで、引数と結果をそれぞれマスキングできます。
- 日本の識別番号には、全角数字への明示的な対応を含むカスタム正規表現が必要です。
- 識別番号が必要なツールには、アクセスを制限した経路で番号を渡し、結果をマスキングしてからエージェントに返すべきです。
ツールとの境界を保護する#
Bedrock Converse リクエストに Guardrail を設定するだけでは、保護に隙間が残ります。機密情報フィルタリングは、toolUse.input、toolResult、ツールの説明やスキーマを評価しません。そのため、識別番号がフィルターの検査を受けずにモデルとツールの間を行き来する可能性があります。
ツールを AgentCore Gateway の背後に配置し、両方のインターセプトポイントに Lambda インターセプターを設定します。REQUEST はツールの実行前に引数を処理し、RESPONSE はエージェントが受け取る前に結果を処理します。この保護は、Gateway を経由する呼び出しにのみ適用されます。
提示された検証では、識別番号を含む架空の従業員情報を返す get_worker と、受け取った引数をそのまま返す register_worker の 2 つの Lambda ツールを使用しました。ツール側のログから、登録ツールが引数を受け取る前に REQUEST のマスキングで識別番号が置換されたことを確認しました。
マスキング経路を設定する#
次の構成要素を設定します。
1. 日本の識別番号に対応するカスタム正規表現を持つ Guardrail を作成します。inputEnabled と outputEnabled を明示的に true にし、両方のアクションを ANONYMIZE に設定します。テストしたインターセプターでは、両方の経路で source="INPUT" を使用しました。 2. インターセプターの Lambda に、その Guardrail に対する bedrock:ApplyGuardrail の呼び出し権限を付与します。Gateway には、インターセプターと対象の Lambda を呼び出す権限を付与します。 3. テスト時の構成に合わせ、IAM 認証を使用し、レスポンスストリーミングを無効にした MCP Gateway を作成します。 4. REQUEST と RESPONSE の両方にインターセプターを設定します。リクエストヘッダーは、インターセプターが必要とする場合にのみ転送します。
REQUEST では、params.arguments 配下の文字列値を再帰的に検査し、transformedGatewayRequest を返します。この時点で transformedGatewayResponse を返すと、ツールの実行がスキップされます。RESPONSE では、テキストコンテンツと structuredContent 内の値を検査します。
tools/call 以外のメソッドは、そのまま通過させます。テストでは、initialize と tools/list に対するインターセプターの呼び出しも確認されました。IAM 認証を使用するクライアントでは、SigV4 でリクエストに署名し、以降のリクエストにネゴシエーション済みの MCP-Protocol-Version ヘッダーを付けます。
ツールごとにポリシーを選ぶ#
引数をマスキングすると、ツールが受け取る内容が変わります。REQUEST ですでに {JP_MY_NUMBER} に置換されていれば、登録ツールは元の識別番号を保存できません。
| ツールの用途 | REQUEST | RESPONSE | |---|---|---| | 文書の検索、レポートの要約、勤務記録の取得 | マスキング | マスキング | | 識別番号の登録、識別番号によるレコード検索 | 必要な識別番号を保持 | マスキング |
例外には、正確なツール名を指定した明示的な許可リストを使用します。未加工の識別番号を受け取るツールを呼び出せるユーザーとエージェントを制限してください。レスポンスのマスキングでは、すでにツールに送信されたデータ、データベースに保存されたデータ、ログに書き込まれたデータは保護できません。
提示されたテストでも、この違いが確認されました。register_worker の REQUEST マスキングを省略すると、ツールは元の値を受け取り、RESPONSE マスキングによって返却結果内の識別番号が置換されました。
正規表現と JSON の制約に対処する#
提示された調査では、確認した Guardrails の組み込み PII 一覧に、日本の識別番号専用のタイプはありませんでした。デプロイ前に最新の一覧を確認し、必要に応じてカスタム正規表現を追加してください。全角数字を含む可能性がある場合は、[0-90-9] を含めます。[0-9] だけでは、全角数字の例を検出できませんでした。
カスタム正規表現は先読み・後読みをサポートしていません。周囲の文字までマッチに含める式は、マスキング時に句読点や JSON の引用符を削除する可能性があります。JSON テキストを解析して値を取り出し、その値をマスキングしてから再度シリアライズしてください。さらに JSON を含む入れ子の文字列には、個別の処理が必要です。先頭のゼロを保持するため、識別番号は文字列として保存します。
正規表現は、同じ形式の業務上の識別番号にも一致します。1,950 件の合成された製造業関連の文では、テストした正規表現がすべての 12 桁の注文番号をマイナンバーとして検出しました。正規表現が重複すると、一部の値に複数の置換タグが生成されました。形式の一致をマイナンバーである証拠と見なさず、ツールとフィールドごとにマスキングを限定してください。
障害時は処理を遮断し、オーバーヘッドを抑える#
無効な Guardrail ID、Guardrail の権限不足、Lambda のタイムアウト、インターセプターの呼び出し権限不足という 4 種類の障害を注入してテストしました。いずれも、マスキングされていない識別番号は返されませんでした。REQUEST の障害はツールの実行を阻止し、RESPONSE の障害はツールの実行後に結果の返却を阻止しました。これらの挙動は、自身のデプロイ環境でも再現して確認してください。
アプリケーションの例外を捕捉し、-32603 Internal error などの汎用的な JSON-RPC エラーを返します。本番環境では、Gateway の例外詳細を DEBUG に設定しないでください。テストでは、このモードでスタックトレースとリソース識別子が露出しました。ログには機密情報を含むペイロードではなく、件数とエラーの種類を記録します。
計測されたインターセプターの処理時間は、REQUEST が約 150~420 ms、RESPONSE が約 130~280 ms でした。文字列ごとに個別に呼び出すと遅延が増え、組み込み PII 検出を有効にしている場合は課金対象の使用量も増加します。バッチ処理をテストし、結果のサイズに上限を設けてください。提示されたテストでは、約 100 KB のマスキングに約 10 秒かかり、2.5 MB 以上のレスポンスでは処理に失敗しました。
次のステップ#
両方のインターセプターを設定した Gateway の背後にツールを 1 つ配置し、架空の識別番号を使って、引数がマスキングされて届くこと、結果がマスキングされて返ること、ApplyGuardrail 権限を削除すると呼び出しが停止することを確認してください。
出典: https://zenn.dev/aws_japan/articles/49bf6abcee64bc
目次
