Amazon Bedrock AgentCore Policyでユーザーごとにツールの呼び出しを制御できるか検証してみた

Amazon Bedrock AgentCore Policyでユーザーごとにツールの呼び出しを制御できるか検証してみた

Amazon Bedrock AgentCore Policyを使い、Cognitoのグループとツールの引数に応じてAgentCore Gatewayのツール呼び出しを制御できるか検証しました。グループによるツールの制限や本人の情報だけを取得させる制御の検証を実施します。
2026.11.20

はじめに

クラスメソッドテクノロジーズの武蔵です。

以前、AgentCore Gatewayのインターセプターでユーザーごとに回答を制御できるかを検証しました。

インターセプターがトークンのユーザー情報をツールの引数に書き込み、ツールのLambdaが返すデータを判定する検証でした。

今回はPolicy in Amazon Bedrock AgentCore(以下、AgentCore Policy)を使用して、リクエストしたユーザーに応じて、ツールの実行前に呼び出しを制御できるかを検証します。

AgentCore Policyとインターセプターの違い

インターセプターは、Amazon Bedrock AgentCore Gateway(以下、AgentCore Gateway)の呼び出しのたびに、Lambdaで任意のコードを実行する仕組みです。

ターゲットを呼ぶ前に動く REQUEST と、ターゲットの応答後に動く RESPONSE があります。

AgentCore Policyは、AgentCore Gatewayを通るリクエストを、ツールへのアクセスを許可する前にポリシーエンジンの Cedar のポリシーで評価する仕組みです。

項目 インターセプター AgentCore Policy
実体 Lambda ポリシーエンジンの Cedar のポリシー
動くタイミング REQUEST: ターゲットを呼ぶ前
RESPONSE: ターゲットの応答後、呼び出し元に返す前
ツールへのアクセスを許可する前

前回は REQUEST インターセプターでユーザー情報を引数に追加し、返すデータはツールのLambdaで判定しました。ツールは実行され、見せない値だけが置き換わります。今回は AgentCore Policyで判定し、拒否するとツールは実行されません。

インターセプターとAgentCore Policyの違い

それぞれの使い分け

呼び出しの可否をユーザーと引数だけで決められる場合は AgentCore Policy、返すデータを加工する場合や、判定にコードが必要な場合はインターセプターを選びます。

やりたいこと 選ぶ仕組み
グループなどのクレームで、呼べるツールを制限する AgentCore Policy
返すデータの一部を隠す・書き換える(例: 給与を 閲覧権限なし にする) インターセプター(RESPONSE)
リクエストに情報を追加してツールに渡す(例: ログインユーザーの情報) インターセプター(REQUEST)

目標

AgentCore Policyで、Cognito のグループとツールの引数に応じて、ツールの呼び出しを許可・拒否できるかを確かめます。強制モードで、実際に呼び出しが止まるかも確認します。

グループと引数で呼び出しを制御する場合

処理の流れ

処理の流れ

① Cognito でログインし、アクセストークン(JWT)を受け取る。

② トークン付きでツールを呼ぶ。

③ トークンを検証する(インバウンド認証)。

④ トークンのクレームとツールの引数を、Cedar のポリシーで判定する。

⑤ 許可されればツールのLambdaを呼び、拒否されれば JSON-RPC のエラーを返す。

事前準備

次の検証用リソースを使います。

リソース 名前
AgentCore Gateway saito-sandbox-multiuser-gw
ツールのLambda saito-sandbox-multiuser-tools
Cognito のユーザープール saito-sandbox-multiuser-pool
AgentCore Gatewayのサービスロール saito-sandbox-multiuser-gw-role

ツールは次の3つです。

ツール 内容 引数
search_faq 社内FAQを検索する keyword
get_employee 社員の部署・役職・給与を取得する user_id
list_salaries 全社員の給与一覧を取得する なし

ユーザーは次の3人です。グループは Cognito のグループで管理しています。

ユーザー ユーザー名 グループ
人物Aさん(開発部 一般) user-a dev
人物Bさん(開発部 一般) user-b dev
人物Cさん(人事部 管理者) user-c hr / admin

ツールの利用可否は次のとおりにします。

ツール 人物Aさん 人物Bさん 人物Cさん
search_faq ○ ○ ○
get_employee 自分の情報のみ 自分の情報のみ ○
list_salaries × × ○

AgentCore Policyを設定する

ポリシーエンジンを作成する

AgentCoreコンソールの左メニューで「ポリシー」を開きます。

ポリシーの画面

「ポリシーエンジンを作成」から saito_sandbox_multiuser_pe を作成しました。

ポリシーエンジンの作成

サービスロールに権限を追加する

AgentCore Gatewayのサービスロールには、次の権限が必要です。

権限 用途
bedrock-agentcore:GetPolicyEngine ポリシーエンジンの設定を取得する
bedrock-agentcore:AuthorizeAction ツールの呼び出しを許可するかを判定する
bedrock-agentcore:PartiallyAuthorizeActions 呼び出せるツールの一覧を判定する

Policyが判定する位置

AWSのドキュメントでは、権限がないと既存のゲートウェイへの関連付けで InternalServerException になり、許可するポリシーがあってもツールの呼び出しはすべて拒否されるとされています。

saito-sandbox-multiuser-gw-role にインラインポリシー policy-engine を追加しました。

サービスロールのインラインポリシー

サービスロールに追加したインラインポリシー
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "bedrock-agentcore:GetPolicyEngine",
      "Resource": "<ポリシーエンジンのARN>"
    },
    {
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:AuthorizeAction",
        "bedrock-agentcore:PartiallyAuthorizeActions"
      ],
      "Resource": [
        "<ポリシーエンジンのARN>",
        "<ゲートウェイARN>"
      ]
    }
  ]
}

AgentCore Gatewayに関連付ける

「アソシエイト ゲートウェイ」から次の内容で関連付けました。

項目 設定値
関連する ゲートウェイ を選択 saito-sandbox-multiuser-gw
強制モード 強制を有効化

「ログのみを出力」は判定をログに出すだけで、呼び出しは止めません。実際の拒否を確かめるため「強制を有効化」を選びました。

関連付けの画面には、ポリシーとゲートウェイのツールが一致せず拒否につながる可能性がある、という警告が表示されました。

ゲートウェイの関連付け

強制モードは「強制済み」になりました。

ポリシーエンジンの詳細

ゲートウェイ側にも「関連ポリシー」として表示されます。

ゲートウェイの関連ポリシー

ポリシーなしで呼んでみる

ポリシーエンジンを関連付けただけの状態で、ツールを呼んでみます。まず3人のアクセストークンを取得します。

アクセストークンを取得するコマンド
REGION='ap-northeast-1'
CLIENT_ID='<クライアントID>'
PASSWORD='<ユーザーのパスワード>'
GW_URL='<ゲートウェイリソースURL>'
COGNITO_URL="https://cognito-idp.${REGION}.amazonaws.com/"

TOKEN_A="$(curl -sS "$COGNITO_URL" \
  -H 'Content-Type: application/x-amz-json-1.1' \
  -H 'X-Amz-Target: AWSCognitoIdentityProviderService.InitiateAuth' \
  -d "$(jq -n --arg c "$CLIENT_ID" --arg p "$PASSWORD" '{AuthFlow:"USER_PASSWORD_AUTH",ClientId:$c,AuthParameters:{USERNAME:"user-a",PASSWORD:$p}}')" \
  | jq -r .AuthenticationResult.AccessToken)"

TOKEN_B="$(curl -sS "$COGNITO_URL" \
  -H 'Content-Type: application/x-amz-json-1.1' \
  -H 'X-Amz-Target: AWSCognitoIdentityProviderService.InitiateAuth' \
  -d "$(jq -n --arg c "$CLIENT_ID" --arg p "$PASSWORD" '{AuthFlow:"USER_PASSWORD_AUTH",ClientId:$c,AuthParameters:{USERNAME:"user-b",PASSWORD:$p}}')" \
  | jq -r .AuthenticationResult.AccessToken)"

TOKEN_C="$(curl -sS "$COGNITO_URL" \
  -H 'Content-Type: application/x-amz-json-1.1' \
  -H 'X-Amz-Target: AWSCognitoIdentityProviderService.InitiateAuth' \
  -d "$(jq -n --arg c "$CLIENT_ID" --arg p "$PASSWORD" '{AuthFlow:"USER_PASSWORD_AUTH",ClientId:$c,AuthParameters:{USERNAME:"user-c",PASSWORD:$p}}')" \
  | jq -r .AuthenticationResult.AccessToken)"

トークンの username と cognito:groups を確認します。以降のコマンドは TOKEN_A をユーザーごとに置き換えて実行しています。

echo "$TOKEN_A" | jq -Rc 'split(".")[1] | gsub("-";"+") | gsub("_";"/") | @base64d | fromjson | {username, groups: ."cognito:groups"}'

人物Aさん(TOKEN_A)のレスポンス

{"username":"user-a","groups":["dev"]}

人物Bさん(TOKEN_B)のレスポンス

{"username":"user-b","groups":["dev"]}

人物Cさん(TOKEN_C)のレスポンス

{"username":"user-c","groups":["admin","hr"]}

cognito:groups は配列です。

ツールの一覧(tools/list)を取得します。

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | jq -c '.error // [.result.tools[].name]'

人物Aさん(TOKEN_A)のレスポンス

[]

人物Bさん(TOKEN_B)のレスポンス

[]

人物Cさん(TOKEN_C)のレスポンス

[]

FAQ を検索(search_faq)します。

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"Tools___search_faq","arguments":{"keyword":"休暇"}}}' \
  | jq -c '.error // .result'

人物Aさん(TOKEN_A)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

人物Bさん(TOKEN_B)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

人物Cさん(TOKEN_C)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

一覧は空になり、呼び出しは denied by default で拒否されました。関連付けた時点で、許可したツール以外は使えなくなります。

作成するCedarのポリシー

「ポリシー を追加」から「Code」を選び、Cedar で次の4つを作成しました。検証モードは「Strict validation mode」と「Permissive mode」から選べます。

ポリシー ツール 許可する条件
search_faq_all search_faq Cognito のユーザー
get_employee_self get_employee 引数の user_id が自分のユーザー名
get_employee_hr get_employee hr グループ
list_salaries_hr list_salaries hr グループ

クレームは principal.getTag("クレーム名")、引数は context.input.引数名 で参照します。

get_employee_selfを作成する

permit(
  principal is AgentCore::OAuthUser,
  action == AgentCore::Action::"Tools___get_employee",
  resource == AgentCore::Gateway::"<ゲートウェイARN>"
)
when {
  principal.hasTag("username") &&
  context.input.user_id == principal.getTag("username")
};

Strict validation mode で作成できました。

get_employee_selfの作成

get_employee_hrとlist_salaries_hrを作成する

AWSのドキュメントでは、配列のクレームは JSON の文字列としてタグに入るとされています。cognito:groups は ["admin","hr"] という文字列になるため、like で判定します。hrx などに当たらないよう、ダブルクォートごと探します。

permit(
  principal is AgentCore::OAuthUser,
  action == AgentCore::Action::"Tools___get_employee",
  resource == AgentCore::Gateway::"<ゲートウェイARN>"
)
when {
  principal.hasTag("cognito:groups") &&
  principal.getTag("cognito:groups") like "*\"hr\"*"
};

get_employee_hrの作成

list_salaries_hr は action だけが異なります。

list_salaries_hr
permit(
  principal is AgentCore::OAuthUser,
  action == AgentCore::Action::"Tools___list_salaries",
  resource == AgentCore::Gateway::"<ゲートウェイARN>"
)
when {
  principal.hasTag("cognito:groups") &&
  principal.getTag("cognito:groups") like "*\"hr\"*"
};

search_faq_allを作成する

username の存在を条件にし、Permissive mode で作成しました。

permit(
  principal is AgentCore::OAuthUser,
  action == AgentCore::Action::"Tools___search_faq",
  resource == AgentCore::Gateway::"<ゲートウェイARN>"
)
when {
  principal.hasTag("username")
};

search_faq_allの作成

作成したポリシーの一覧です。

ポリシーの一覧

検証

アクセストークンを取得し直し、3人でツールを呼びました。

ツールの一覧を取得する

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | jq -c '.error // [.result.tools[].name]'

人物Aさん(TOKEN_A)のレスポンス

["Tools___get_employee","Tools___search_faq"]

人物Bさん(TOKEN_B)のレスポンス

["Tools___get_employee","Tools___search_faq"]

人物Cさん(TOKEN_C)のレスポンス

["Tools___get_employee","Tools___list_salaries","Tools___search_faq"]

人物Aさんと人物Bさんの一覧からは list_salaries が消えました。AWSのドキュメントでは、一覧は引数を含めずに判定され、呼び出しが許可される可能性があるツールは表示されるとされています。そのため、引数次第で許可される get_employee は表示されます。

ツールの一覧は引数なしで判定される

FAQを検索する

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"Tools___search_faq","arguments":{"keyword":"休暇"}}}' \
  | jq -c '.error // .result'

人物Aさん(TOKEN_A)のレスポンス

{"content":[{"type":"text","text":"{\"items\": [{\"category\": \"休暇\", \"question\": \"リフレッシュ休暇はいつ取得できますか?\", \"answer\": \"勤続3年ごとに5日付与されます。\"}]}"}]}

人物Bさん(TOKEN_B)のレスポンス

{"content":[{"type":"text","text":"{\"items\": [{\"category\": \"休暇\", \"question\": \"リフレッシュ休暇はいつ取得できますか?\", \"answer\": \"勤続3年ごとに5日付与されます。\"}]}"}]}

人物Cさん(TOKEN_C)のレスポンス

{"content":[{"type":"text","text":"{\"items\": [{\"category\": \"休暇\", \"question\": \"リフレッシュ休暇はいつ取得できますか?\", \"answer\": \"勤続3年ごとに5日付与されます。\"}]}"}]}

3人とも取得できました。

人物Aさんの社員情報を取得する

user_id に user-a を指定します。

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"Tools___get_employee","arguments":{"user_id":"user-a"}}}' \
  | jq -c '.error // .result'

人物Aさん(TOKEN_A)のレスポンス

{"content":[{"type":"text","text":"{\"item\": {\"user_id\": \"user-a\", \"name\": \"人物A\", \"department\": \"開発部\", \"title\": \"一般\", \"salary\": 5000000}}"}]}

人物Bさん(TOKEN_B)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

人物Cさん(TOKEN_C)のレスポンス

{"content":[{"type":"text","text":"{\"item\": {\"user_id\": \"user-a\", \"name\": \"人物A\", \"department\": \"開発部\", \"title\": \"一般\", \"salary\": 5000000}}"}]}
ユーザー 結果 当てはまったポリシー
人物Aさん(開発部 一般) 許可 get_employee_self
人物Bさん(開発部 一般) 拒否 なし
人物Cさん(人事部 管理者) 許可 get_employee_hr

人物Bさんの社員情報を取得する

user_id に user-b を指定します。

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"Tools___get_employee","arguments":{"user_id":"user-b"}}}' \
  | jq -c '.error // .result'

人物Aさん(TOKEN_A)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

人物Bさん(TOKEN_B)のレスポンス

{"content":[{"type":"text","text":"{\"item\": {\"user_id\": \"user-b\", \"name\": \"人物B\", \"department\": \"開発部\", \"title\": \"一般\", \"salary\": 5500000}}"}]}

人物Cさん(TOKEN_C)のレスポンス

{"content":[{"type":"text","text":"{\"item\": {\"user_id\": \"user-b\", \"name\": \"人物B\", \"department\": \"開発部\", \"title\": \"一般\", \"salary\": 5500000}}"}]}
ユーザー 結果 当てはまったポリシー
人物Aさん(開発部 一般) 拒否 なし
人物Bさん(開発部 一般) 許可 get_employee_self
人物Cさん(人事部 管理者) 許可 get_employee_hr

人物Aさんと人物Bさんは自分の情報だけを取得できました。

他人のuser_idを指定した場合

全社員の給与一覧を取得する

curl -sS -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"Tools___list_salaries","arguments":{}}}' \
  | jq -c '.error // .result'

人物Aさん(TOKEN_A)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

人物Bさん(TOKEN_B)のレスポンス

{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}

人物Cさん(TOKEN_C)のレスポンス

{"content":[{"type":"text","text":"{\"items\": [{\"user_id\": \"user-a\", \"name\": \"人物A\", \"salary\": 5000000}, {\"user_id\": \"user-b\", \"name\": \"人物B\", \"salary\": 5500000}, {\"user_id\": \"user-c\", \"name\": \"人物C\", \"salary\": 8000000}]}"}]}

hr グループの人物Cさんだけが取得できました。

拒否されたときのレスポンスを確認する

HTTP ステータスとレスポンス全体を確認します。

curl -sS -w '\nHTTP %{http_code}\n' -X POST "$GW_URL" \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN_A" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"Tools___list_salaries","arguments":{}}}'

人物Aさん(TOKEN_A)のレスポンス

{"jsonrpc":"2.0","id":1,"error":{"code":-32002,"message":"Tool Execution Denied: Tool call not allowed due to policy enforcement [No policy applies to the request (denied by default).]"}}
HTTP 200

拒否は HTTP 200 で、JSON-RPC の error(-32002)として返ります。

まとめ

AgentCore Policyで、Cognito のグループとツールの引数に応じて、ツールの呼び出しを制御できました。

配列のクレーム cognito:groups は like で判定でき、引数とトークンの username を比べることで、本人の情報だけを取得させられました。

ポリシーエンジンを関連付けた時点で、許可していないツールはすべて拒否されます。また、ツールの一覧は引数なしで判定されるため、引数で制御するツールは呼べないユーザーの一覧にも表示されます。

今回は curl での確認です。Claude などのクライアントから呼んだときの見え方は、別途確認が必要です。

参考

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事