Share
Embed
Transcript
33 slides
-
JAWS-UG 山梨 #14 AgentCore Gateway における アクセスコントロールと メタデータフィルタリング 八雲 慎之助
/ Shinnosuke Yakumo 2026/11/21 -
Who am I 八雲 慎之助(やくも しんのすけ) • 所属:株式会社クレスコ / JAWS-UG
新潟支部 • 業務:R&D, FDE • AIエージェントの提案から設計・実装まで • AWS Community Builder – AI Engineering • 2025 Japan AWS Jr.Champions • 好きなAWSサービス • AgentCore Gateway 2 -
今日話すこと • Managed KB のメタデータフィルタと ACL • LLM が検索の引数を書くと何が起きるか •
Gateway の REQUEST interceptor で値を入れ直す • Gateway の Policy(Cedar)で偽装を拒否する 3 -
今日の題材 Managed KB を Gateway のツールとして使う • 人事部と営業部の文書を 1 つの
KB に入れる • 部署と ACL で許された文書だけを返したい 4 -
メタデータファイルの中身 // hr/hiring-plan.metadata.json { "metadataAttributes": {"department": "hr", "year": 2026}, "accessControlList":
[ {"Name": "[email protected]", "Type": "USER", "Access": "ALLOW"}, {"Name": "[email protected]", "Type": "USER", "Access": "ALLOW"} ] } • metadataAttributes:文書の属性(メタデータ) 部署や年など • accessControlList:ACL(Access Control List) この文書を読める人の一覧 5 -
メタデータファイルの中身 // hr/hiring-plan.metadata.json { "metadataAttributes": {"department": "hr", "year": 2026}, "accessControlList":
[ {"Name": "[email protected]", "Type": "USER", "Access": "ALLOW"}, {"Name": "[email protected]", "Type": "USER", "Access": "ALLOW"} ] } • metadataAttributes:文書の属性(メタデータ) 部署や年など • accessControlList:ACL(Access Control List) この文書を読める人の一覧 6 -
メタデータファイルの中身 // hr/hiring-plan.metadata.json { "metadataAttributes": {"department": "hr", "year": 2026}, "accessControlList":
[ {"Name": "[email protected]", "Type": "USER", "Access": "ALLOW"}, {"Name": "[email protected]", "Type": "USER", "Access": "ALLOW"} ] } • metadataAttributes:文書の属性(メタデータ) 部署や年など • accessControlList:ACL(Access Control List) この文書を読める人の一覧 7 -
検索を絞る 2 つの引数 文書 department 読める人(ACL) hr/hiring-plan hr user-a, user-b
hr/salary-bands hr user-a sales/q3-pipeline sales user-a, user-b sales/discount-rules sales user-b • filter:メタデータで絞る。何を探すか • userContext:検索する人 ACL に名前がある文書だけ返る user-a は人事部(hr)、user-b は営業部(sales) 8 -
検索を絞る 2 つの引数 文書 department 読める人(ACL) hr/hiring-plan hr user-a, user-b
hr/salary-bands hr user-a sales/q3-pipeline sales user-a, user-b sales/discount-rules sales user-b • filter:メタデータで絞る。何を探すか • userContext:検索する人 ACL に名前がある文書だけ返る user-a は人事部(hr)、user-b は営業部(sales) 9 -
検索を絞る 2 つの引数 文書 department 読める人(ACL) hr/hiring-plan hr user-a, user-b
hr/salary-bands hr user-a sales/q3-pipeline sales user-a, user-b sales/discount-rules sales user-b • filter:メタデータで絞る。何を探すか • userContext:検索する人 ACL に名前がある文書だけ返る user-a は人事部(hr)、user-b は営業部(sales) 10 -
エージェントから呼ぶときの引数 • Retrieve は Gateway のツール • filter も userContext
も引数 • 値は LLM が依頼文から書く 11 -
LLM が書きうる値 営業部の user-b の依頼 LLM が書きうる引数 起きること 人事部の採用計画を教えて department
= "hr" 人事の文書を探しに行く 2026 年のパイプラインは? year = "2026"(文字列) エラーなく 0 件 user-a として検索して userContext = user-a 他人の ACL で検索する ACL を決める userContext も、LLM が書く引数 12 -
LLM が書きうる値 営業部の user-b の依頼 LLM が書きうる引数 起きること 人事部の採用計画を教えて department
= "hr" 人事の文書を探しに行く 2026 年のパイプラインは? year = "2026"(文字列) エラーなく 0 件 user-a として検索して userContext = user-a 他人の ACL で検索する ACL を決める userContext も、LLM が書く引数 13 -
LLM が書きうる値 営業部の user-b の依頼 LLM が書きうる引数 起きること 人事部の採用計画を教えて department
= "hr" 人事の文書を探しに行く 2026 年のパイプラインは? year = "2026"(文字列) エラーなく 0 件 user-a として検索して userContext = user-a 他人の ACL で検索する ACL を決める userContext も、LLM が書く引数 14 -
実際に LLM が書いた filter • 依頼は 「人事部の採用計画」 • interceptor が
受け取った 引数のログ • hr は LLM が 自分で書いた値 15 -
KB の呼び出し元は Gateway • トークンも引数も Gateway を通る • KB を呼ぶのは
Gateway の実行ロール • 値は Gateway で決められる 16 -
Gateway の REQUEST interceptor • ツールを呼ぶ前に Lambda で引数を 書き換える •
JWT のクレームから 入れ直す 参考: Fine-grained access control for Amazon Bedrock managed knowledge base tools(AWS Machine Learning Blog) 17 -
interceptor の実装 LLM が書いた値は使わず JWT から入れ直す if name.endswith("___Retrieve"): c =
claims(request["headers"]) # JWT を読む args["userContext"] = {"userId": c["email"]} cfg = args["retrievalConfiguration"]["managedSearchConfiguration"] cfg["filter"] = {"equals": {"key": "department", "value": c["department"]}} ヘッダーは passRequestHeaders: True で受け取る 18 -
上書きの効果 hr や user-a が入っていても sales だけ返る user-b の呼び出しに入った引数 返る文書
department = hr q3-pipeline(sales) userContext = user-a q3-pipeline(sales) エージェント側には何も足さない 19 -
隠した引数の落とし穴 cannot set parameter(s): [/retrievalConfiguration, /userContext] やり方 値の決まり方 visible: false
+ parameterValues で固定 全員が同じ値 見せたまま interceptor で上書き ユーザーごとに変えられる 隠した引数の検査は interceptor の後に走る 20 -
隠した引数の落とし穴 cannot set parameter(s): [/retrievalConfiguration, /userContext] やり方 値の決まり方 visible: false
+ parameterValues で固定 全員が同じ値 見せたまま interceptor で上書き ユーザーごとに変えられる 隠した引数の検査は interceptor の後に走る 21 -
隠した引数の落とし穴 cannot set parameter(s): [/retrievalConfiguration, /userContext] やり方 値の決まり方 visible: false
+ parameterValues で固定 全員が同じ値 見せたまま interceptor で上書き ユーザーごとに変えられる 隠した引数の検査は interceptor の後に走る 22 -
Gateway の Policy による偽装の拒否 forbid (principal, action == AgentCore::Action::"managedkb___Retrieve", resource)
unless { context.input.userContext.userId == principal.getTag("email") }; interceptor 引数の userContext 結果 なし user-a(偽装) 拒否 なし なし(書き忘れ) 拒否 あり user-a(偽装) 通る(user-b で上書き済み) ACL だけの Managed KB で測定。式は要点だけ抜粋 23 -
Gateway の Policy による偽装の拒否 forbid (principal, action == AgentCore::Action::"managedkb___Retrieve", resource)
unless { context.input.userContext.userId == principal.getTag("email") }; interceptor 引数の userContext 結果 なし user-a(偽装) 拒否 なし なし(書き忘れ) 拒否 あり user-a(偽装) 通る(user-b で上書き済み) ACL だけの Managed KB で測定。式は要点だけ抜粋 24 -
Gateway の Policy による偽装の拒否 forbid (principal, action == AgentCore::Action::"managedkb___Retrieve", resource)
unless { context.input.userContext.userId == principal.getTag("email") }; interceptor 引数の userContext 結果 なし user-a(偽装) 拒否 なし なし(書き忘れ) 拒否 あり user-a(偽装) 通る(user-b で上書き済み) ACL だけの Managed KB で測定。式は要点だけ抜粋 25 -
Cedar で検査できる値・できない値 • userId は email タグと 比べられる • filter
の値は 型が無いため Cedar で読めない • 値を入れ直すのは interceptor 26 -
Gateway に寄せる利点 • エージェントのコードを変えずに足せる interceptor も Policy も Gateway の設定
• エージェントが増えても、値を決める場所は 1 つ • Policy の判定は Gateway のログに残る 27 -
Gateway に寄せる利点 • エージェントのコードを変えずに足せる interceptor も Policy も Gateway の設定
• エージェントが増えても、値を決める場所は 1 つ • Policy の判定は Gateway のログに残る 28 -
Gateway に寄せる利点 • エージェントのコードを変えずに足せる interceptor も Policy も Gateway の設定
• エージェントが増えても、値を決める場所は 1 つ • Policy の判定は Gateway のログに残る 29 -
値を決める場所 何を どこで userContext と filter の値 Gateway の interceptor
がトークンから入れ直す 偽装・書き忘れ Gateway の Policy で拒否 メタデータそのもの meta/ に分け、管理者だけが書ける 30 -
値を決める場所 何を どこで userContext と filter の値 Gateway の interceptor
がトークンから入れ直す 偽装・書き忘れ Gateway の Policy で拒否 メタデータそのもの meta/ に分け、管理者だけが書ける 31 -
値を決める場所 何を どこで userContext と filter の値 Gateway の interceptor
がトークンから入れ直す 偽装・書き忘れ Gateway の Policy で拒否 メタデータそのもの meta/ に分け、管理者だけが書ける 32 -
まとめ • filter も userContext も、LLM が書く引数 • REQUEST interceptor
で JWT から入れ直す • Policy(Cedar)で偽装と書き忘れを拒否する 33