Upgrade to Pro — share decks privately, control downloads, hide ads and more …

【日本語版】Access control and metadata filtering in ...

やくも
November 21, 2026

【日本語版】Access control and metadata filtering in AgentCore Gateway

やくも

November 21, 2026

Transcript

33 slides
  1. Who am I 八雲 慎之助(やくも しんのすけ) • 所属:株式会社クレスコ / JAWS-UG

    新潟支部 • 業務:R&D, FDE • AIエージェントの提案から設計・実装まで • AWS Community Builder – AI Engineering • 2025 Japan AWS Jr.Champions • 好きなAWSサービス • AgentCore Gateway 2
  2. 今日話すこと • Managed KB のメタデータフィルタと ACL • LLM が検索の引数を書くと何が起きるか •

    Gateway の REQUEST interceptor で値を入れ直す • Gateway の Policy(Cedar)で偽装を拒否する 3
  3. 今日の題材 Managed KB を Gateway のツールとして使う • 人事部と営業部の文書を 1 つの

    KB に入れる • 部署と ACL で許された文書だけを返したい 4
  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
  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
  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
  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
  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
  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
  10. LLM が書きうる値 営業部の user-b の依頼 LLM が書きうる引数 起きること 人事部の採用計画を教えて department

    = "hr" 人事の文書を探しに行く 2026 年のパイプラインは? year = "2026"(文字列) エラーなく 0 件 user-a として検索して userContext = user-a 他人の ACL で検索する ACL を決める userContext も、LLM が書く引数 12
  11. LLM が書きうる値 営業部の user-b の依頼 LLM が書きうる引数 起きること 人事部の採用計画を教えて department

    = "hr" 人事の文書を探しに行く 2026 年のパイプラインは? year = "2026"(文字列) エラーなく 0 件 user-a として検索して userContext = user-a 他人の ACL で検索する ACL を決める userContext も、LLM が書く引数 13
  12. LLM が書きうる値 営業部の user-b の依頼 LLM が書きうる引数 起きること 人事部の採用計画を教えて department

    = "hr" 人事の文書を探しに行く 2026 年のパイプラインは? year = "2026"(文字列) エラーなく 0 件 user-a として検索して userContext = user-a 他人の ACL で検索する ACL を決める userContext も、LLM が書く引数 14
  13. 実際に LLM が書いた filter • 依頼は 「人事部の採用計画」 • interceptor が

    受け取った 引数のログ • hr は LLM が 自分で書いた値 15
  14. KB の呼び出し元は Gateway • トークンも引数も Gateway を通る • KB を呼ぶのは

    Gateway の実行ロール • 値は Gateway で決められる 16
  15. Gateway の REQUEST interceptor • ツールを呼ぶ前に Lambda で引数を 書き換える •

    JWT のクレームから 入れ直す 参考: Fine-grained access control for Amazon Bedrock managed knowledge base tools(AWS Machine Learning Blog) 17
  16. 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
  17. 上書きの効果 hr や user-a が入っていても sales だけ返る user-b の呼び出しに入った引数 返る文書

    department = hr q3-pipeline(sales) userContext = user-a q3-pipeline(sales) エージェント側には何も足さない 19
  18. 隠した引数の落とし穴 cannot set parameter(s): [/retrievalConfiguration, /userContext] やり方 値の決まり方 visible: false

    + parameterValues で固定 全員が同じ値 見せたまま interceptor で上書き ユーザーごとに変えられる 隠した引数の検査は interceptor の後に走る 20
  19. 隠した引数の落とし穴 cannot set parameter(s): [/retrievalConfiguration, /userContext] やり方 値の決まり方 visible: false

    + parameterValues で固定 全員が同じ値 見せたまま interceptor で上書き ユーザーごとに変えられる 隠した引数の検査は interceptor の後に走る 21
  20. 隠した引数の落とし穴 cannot set parameter(s): [/retrievalConfiguration, /userContext] やり方 値の決まり方 visible: false

    + parameterValues で固定 全員が同じ値 見せたまま interceptor で上書き ユーザーごとに変えられる 隠した引数の検査は interceptor の後に走る 22
  21. 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
  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 で測定。式は要点だけ抜粋 24
  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 で測定。式は要点だけ抜粋 25
  24. Cedar で検査できる値・できない値 • userId は email タグと 比べられる • filter

    の値は 型が無いため Cedar で読めない • 値を入れ直すのは interceptor 26
  25. Gateway に寄せる利点 • エージェントのコードを変えずに足せる interceptor も Policy も Gateway の設定

    • エージェントが増えても、値を決める場所は 1 つ • Policy の判定は Gateway のログに残る 27
  26. Gateway に寄せる利点 • エージェントのコードを変えずに足せる interceptor も Policy も Gateway の設定

    • エージェントが増えても、値を決める場所は 1 つ • Policy の判定は Gateway のログに残る 28
  27. Gateway に寄せる利点 • エージェントのコードを変えずに足せる interceptor も Policy も Gateway の設定

    • エージェントが増えても、値を決める場所は 1 つ • Policy の判定は Gateway のログに残る 29
  28. 値を決める場所 何を どこで userContext と filter の値 Gateway の interceptor

    がトークンから入れ直す 偽装・書き忘れ Gateway の Policy で拒否 メタデータそのもの meta/ に分け、管理者だけが書ける 30
  29. 値を決める場所 何を どこで userContext と filter の値 Gateway の interceptor

    がトークンから入れ直す 偽装・書き忘れ Gateway の Policy で拒否 メタデータそのもの meta/ に分け、管理者だけが書ける 31
  30. 値を決める場所 何を どこで userContext と filter の値 Gateway の interceptor

    がトークンから入れ直す 偽装・書き忘れ Gateway の Policy で拒否 メタデータそのもの meta/ に分け、管理者だけが書ける 32
  31. まとめ • filter も userContext も、LLM が書く引数 • REQUEST interceptor

    で JWT から入れ直す • Policy(Cedar)で偽装と書き忘れを拒否する 33

More Decks by やくも

Other Decks in Technology