Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

エージェントアイデンティティと代理(OBO)委任:誰が実際にツールを呼び出しているのか?

Published: 11月 20, 2026

要約:

AIエージェントがツールを呼び出す際、「これはどのユーザーのためのものか」「どのエージェントが動作しているか」という2つの疑問に同時に答えられる必要があります。しかし、ほとんどの構成ではどちらか一方にしか答えられません。

  • エージェントはユーザーでもサービスアカウントでもありません。ユーザーのトークンを与えると監査ログからエージェントの情報が失われ、共有サービスアカウントを与えるとユーザーの情報が失われます。どちらも認可の破綻につながります。
  • 代理(OBO)委任により、エージェントは特定のユーザーに代わって動作し、両方のアイデンティティを保持できます。ダウンストリームシステムにはユーザー(sub)と実行中のエージェント(act)の両方が表示されます。
  • TrueFoundryはこれを2つのヘッダーで渡します。Authorization内のユーザートークンと、x-tfy-agent-authorization内のエージェントアイデンティティトークンです。ユーザートークンはエンドツーエンドで変更されず、エージェントトークンはホップごとに置き換えられます。
  • 委任はコラボレーターによって制限されます。エージェントはアクセス権を付与したユーザーの代わりにしか動作できず、ターゲットに到達する権限と誰かの代わりに動作する権限は個別に管理されます。
  • これはLLM Gateway、MCP Gateway、Agent Gatewayの前段にあるゲートウェイ上で動作するため、ツールへの既存のアウトバウンド認証は変更なしでそのまま機能します。(エージェントアイデンティティ機能はBeta版です。)

なぜエージェントに独自のアイデンティティが必要なのか

自律型エージェントにツールへのアクセス権を与えると、既存のIAMでは想定されていなかった問題に直面します。エージェントがZendeskのチケットを読み取ったり、データベースにクエリを送信したりした際、それを実行したのは誰でしょうか?よくある3つの答えがありますが、いずれも適切ではありません。

  • ユーザーのトークンを使用する。 ダウンストリームシステムはエージェントが関与したかどうかを全く判断できず、すべての操作が人間によって直接行われたように見えます。
  • 共有サービスアカウントを使用する。 どのユーザーのデータに触れたかが分からなくなり、30人分のリクエストが単一の主体(プリンシパル)に集約されてしまいます。
  • ユーザーになりすます。 意思決定におけるエージェントの役割が隠されてしまい、監査時に最も確認される部分の透明性が失われます。

いずれの場合も、監査ログは不完全になり、認可は大まかなものにとどまり、ポリシーによって人間の操作と自律的な操作を区別できません。エージェントアイデンティティは、エージェントをファーストクラスの主体(自身として、またはユーザーに代わって動作できる主体)とすることで、この問題を解決します。全体像については、AIエージェントアイデンティティとは何かおよびAIエージェントガバナンスを参照してください。

「代理(On Behalf Of)」の真の意味

代理(On-Behalf-Of)委任とは、2つの主体を保持するトークンのことです。RFC 8693のトークン交換パターンに基づいて構築された結果のトークンは、subをユーザーに、actをエージェントに設定します(「このエージェントによって動作する、このユーザー」)。そのトークンの権限(scp)は、ユーザーが実行できることとエージェントが許可されていることの交差領域(共通部分)になるため、エージェントがユーザーの権限範囲を超えて拡張することは決してありません。

一連のエージェントのチェーンでは、actクレームが入れ子になります(例: ユーザーの代わりに行動するリサーチエージェントの代わりに行動するデータエージェント)。すべてのホップが記録されるため、完全な委任パスは1つのアクターに統合されることなく、監査ログで確認できます。

ユーザーは各ホップで一定に保たれ、動作するエージェントが変更されます。

すべてのリクエストに含まれる2つのヘッダー

TrueFoundryでは、エージェントを登録するときにそのアイデンティティが作成されます。登録された各エージェントは一意のアイデンティティを1つ持ち、TrueFoundry管理(Gatewayがトークンを発行および署名)またはOktaやMicrosoft Entraによるアイデンティティプロバイダー管理を選択できます。どちらの場合もアイデンティティの意味は同じであり、発行者のみが異なります。

エージェントの身元証明方法の選択: TrueFoundry管理またはアイデンティティプロバイダー管理。出典: TrueFoundryドキュメント。

Gatewayへのすべてのリクエストには、2つのベアラートークンが含まれます。

AuthorizationヘッダーはユーザーのSSOトークンであり、エンドツーエンドで変更されずに通過します。x-tfy-agent-authorizationヘッダーは現在動作しているエージェントであり、各エージェントは次のホップを呼び出す前にこれを自身のアクティブなアイデンティティに置き換えます。エージェントヘッダーが存在しない場合、リクエストは通常のユーザー呼び出しとして扱われ、ユーザーの権限のみで認可されます。この同じヘッダーペアは、LLM Gateway(/api/llm/chat/completions)、MCP Gateway(/mcp/<server>/server)、Agent Gateway(/agent/<agent-name>)の3つの領域すべてで共通して機能します。

誰が誰の代わりに行動できるか: コラボレーター

委任は無制限に行われるわけではありません。エージェントのアクセス制御(Access Control)ステップにおけるコラボレーターによって制限され、これには2つのロールが存在します。

  • Agent Manager — エージェントとその設定を編集できます。
  • Agent Access — エージェントを呼び出すことができ、そのエージェントによって代行されることができます。この権限が付与されていないユーザーは、ターゲットに直接アクセスできたとしても、委任された呼び出しの対象になることはできません。
アクセス制御: エージェントを管理するユーザーと、エージェントが誰に代わって動作できるかの設定。出典: TrueFoundryドキュメント。

コラボレーターにはユーザー、チーム、またはバーチャルアカウントを指定できるため、人間以外のワークロードも委任できます。この仕組みにより、エージェントが組織内の誰の代わりにも勝手に動作しないよう制御されます。委任は、明示的に許可を与えたアイデンティティに対してのみ機能します。

ターゲットへの到達は個別のアクセス権限

ユーザーの代わりに行動することを許可されるのは1つの権限です。指定されたツールに到達することを許可されるのは別の権限であり、両方が満たされている必要があります。MCPサーバーのコラボレーターリストでは、エージェントはユーザーやチームと並んで表示され、独自のロールを持ちます: MCP Server User(ツールの呼び出し)およびMCP Server Manager(管理)。

コラボレーターピッカーのエージェントタブからMCPサーバーへのアクセス権をエージェントに付与。出典: TrueFoundryドキュメント。

YAMLマニフェストでは、意図を明確にするために、同じ権限付与に主体プレフィックスを使用します。

これら2つの権限分離が、最小権限の原則を実現します。ユーザーが使用できるエージェントであっても、追加されていないツールにタッチすることはできません。これは、MCP認可とは何かや細粒度の認可で説明している認可モデルを反映しています。

誰が、そしてどのエージェントが各ツールを呼び出したかを正確に確認してみませんか?

マルチホップ呼び出しの認可の仕組み

このモデルを把握する最も明確な方法は、1つのリクエストの流れを追うことです。Janeがプランナーエージェントにリクエストを送り、それがリサーチエージェントに委任され、最終的にZendesk MCPサーバーを呼び出します。ユーザートークンは一切変更されませんが、エージェントトークンは変更され、Gatewayは各ホップを独自の権限に基づいて検証します。

ホップAuthorizationx-tfy-agent-authorizationGatewayの検証内容
Jane → planner-agentJane(なし)Janeはplanner-agentを呼び出せますか?
planner-agent → research-agentJaneplanner-agentplannerはresearch-agentを呼び出し、Janeの代わりに行動できますか?
research-agent → Zendesk MCPJaneresearch-agentresearch-agentはサーバーのコラボレーターであり、Janeの代わりに行動できますか?

各エージェントは、独自の権限に基づいてのみ認可されます。呼び出し元の権限範囲を継承することはありません。アウトバウンド側は変更されません。MCPサーバーの既存の認証(OAuth2、共有APIキー、またはトークンパススルー)は、再設定することなくそのまま機能します。Gatewayが行うのは、(ユーザー、エージェント)ペアの解決と認可のみです。

陥りやすい誤り

  • 共有サービスアカウントを「エージェントアイデンティティ」として扱うこと。 サービスアカウントはエージェント自身を表しますが、誰の代わりにも行動できません。そのため、誰のデータにアクセスしたかを特定できません。委任機能の活用こそが重要なポイントです。
  • ツールにアクセスできればユーザーの代わりに行動できると仮定すること。 これらは独立した権限です。サーバー上のコラボレーターであるエージェントであっても、代理行動を行おうとする特定のユーザーに対するAgent Access権限が別途必要です。
  • モデル自体に独自のアイデンティティトークンを読み取らせること。 自身のx-tfy-agent-authorizationトークンを開示できるプロンプト済みエージェントは、なりすまされる危険性があります。ソース管理やモデルが読み取り可能な場所からは隔離してください。
  • チェーンを単一化すること。 マルチエージェントシステムが1つのサービスアカウントに統合されてしまうと、ネストされたactクレームが失われ、誰が何をしたのかを監査ログから再構築できなくなります。委任チェーンはホップごとに保持してください。

具体的な実装例

サポート自動化チームが、専門エージェントにタスクを分散するプランナーエージェントを運用しており、その専門エージェントの1つがZendeskからチケットを読み取るとします。チームの要件は次の3つです: すべてのアクションに人間のリクエスターを記録すること、実際に動作した特定のエージェントを記録すること、明示的に許可されていないツールへのエージェントのアクセスを防ぐことです。

  1. 各エージェントを登録して独自のアイデンティティを付与します。ここではエージェント自体の構築と運用をチーム内で行うため、TrueFoundry管理を選択します。
  2. 各エージェントのアクセス制御(Access Control)で、サポートチームをAgent Accessとして追加し、エージェントがそれらのユーザーの代わりに行動できるようにします。
  3. Zendesk MCPサーバーには、チケット読み取りエージェントのみをMCP Server Userとして追加します。プランナーはZendeskに直接アクセスしません。
  4. Authorizationにユーザートークン、x-tfy-agent-authorizationにエージェントトークンを設定してリクエストを送信します。各エージェントは自分自身のトークンに置き換えて後続へ渡します。
  5. 監査ログを確認します: Zendeskへのすべての読み取りアクセスに、リクエスター、実行エージェント、および完全な委任チェーンが記録されます。

重要な注意点: これは「誰が誰の代わりに行動でき、何にアクセスできるか」を管理するものです。MCPサーバー自体のアウトバウンド認証情報を置き換えるものではありません。それらは既存のまま維持されるため、既存ツールを再構築することなく導入できます。

知っておくべき注意事項

  • エージェントアイデンティティはBeta機能です — 挙動や設定が変更される可能性があるため、ドキュメントに記載されたフローに固定し、大規模な展開前に再確認してください。
  • アイデンティティプロバイダー管理のエージェントはIdP(OktaまたはEntra)への登録も必要です。TrueFoundry管理のエージェントは外部登録を必要としません。
  • 拒否された呼び出しは403を返します。拒否された主体と理由が示されます。Agent Access権限がないユーザーは、ターゲットに直接アクセスできたとしても、委任された呼び出しでは拒否されます。
  • OBOトークンの権限はユーザーとエージェントのスコープの交差領域(共通部分)となります。そのため、どちらか一方を制限すると委任呼び出し全体が制限されます。拒否(forbid)ポリシーは許可(permit)よりも優先されます。
  • 委任とアクセス可能性は独立しています — 予期しない拒否(または予期しない許可)が発生した場合は、片方だけでなく両方の権限設定を監査してください。

エージェントがOBOトークンを取得する3つの方法

2ヘッダーモデルにおいて、トークン交換を誰が実行するかには、エージェントのアイデンティティタイプに応じた3つの選択肢があります。利便性と、信頼およびシークレットの保持場所とのトレードオフになります。

モードOBO交換の実行者外部IdPへの登録最適なシナリオ
Managed credentials(管理された認証情報)TrueFoundry必要 (Okta または Azure AD)ゲートウェイ側でエージェントのOAuthクライアントの保持と更新を行いたい場合
Federated token(フェデレーショントークン)エージェント自身必要エージェントがすでに独自のトークン交換を実行し、OBOトークンを送信している場合
Virtual account(バーチャルアカウント)不要不要IdPへの登録を行わずにガバナンスの利いた委任を実現したい場合

Managed credentialsでは、エージェントのOAuthクライアントがIdPに登録され、TrueFoundryがその認証情報をシークレットとして保存します。その後、ユーザートークンをサブジェクトトークンとしてトークン交換を実行し、結果をキャッシュして更新します。Federated tokenでは、エージェントがTrueFoundryの外部でトークン交換を行い、生成されたOBOトークンを送信します。ゲートウェイはレジストリとの照合を行う前に、jwks_uri、発行者(issuer)、オーディエンス(audience)、およびagent_claim(デフォルトはact.sub)を用いてトークンを検証します。照合に失敗した場合は403が返されます。Virtual accountでは、呼び出し元が2つのトークン(Authorization: Bearer <virtual-account-token>とX-TFY-User-Token: <user-sso-token>)を送信し、ユーザーコンテキストはIdP発行のOBOトークンではなくTrueFoundry自身のアウトバウンド認証によって渡されます。標準のRFC 8693トークンを厳密に要求するサーバーには、他の2つのモードのいずれかを使用する必要があります。

ゲートウェイによるペアの認可手順

(ユーザー、エージェント)のアイデンティティを解決することは最初のステップに過ぎず、全体のプロセスの一部です。ペアが特定されると、リクエストがツールに届く前に短い評価が実行され、各レイヤーはアクセスを制限する方向にのみ機能します。

  1. 2つのヘッダーから(ユーザー、エージェント)のアイデンティティを解決します。
  2. RBAC — ユーザー: ユーザーはMCPサーバーのコラボレーターである必要があります。
  3. RBAC — エージェント: エージェントもコラボレーターである必要があります(主体はagent:<agent-name>)。
  4. ツールスコープ: リクエストされたツールがエージェントのオプショナルツールリストに設定されている場合、その中に含まれている必要があります。
  5. ポリシー: 任意のCedarポリシーが実行されます。常に拒否(forbid)が許可(permit)よりも優先されます。
  6. 固有のアウトバウンド認証を使用してMCPサーバーにフォワードします。

これが、委任が構造的に安全である理由です。OBOトークン自体のスコープはすでにユーザーとエージェントの権限の交差領域であり、さらに呼び出しが通過する前に4つの独立した認可チェックが合意する必要があります。いずれかの制限(ユーザーのコラボレーターロールの削除、エージェントの削除、ツールリストの削減、Cedar拒否の追加)を行うと、委任された呼び出しの制限が強化されます。完全な監査ログには、ユーザー、エージェント、アイデンティティモード、委任チェーン、サーバーとツール、RBACとCedarの決定結果、使用されたスコープ、およびステータスが記録されます。

関連ドキュメント

まとめ

ユーザーのトークンを借用したり、サービスアカウントの陰に隠れたりするエージェントは、監査人や攻撃者によって発見されるリスクを抱えています。エージェントアイデンティティは、エージェントを独立した主体とすることでこの問題を解決し、代理委任によってその主体が特定のユーザーに代わって両方のアイデンティティを保持しながらホップを超えて動作できるようにします。

その仕組みは、2つのヘッダー、2種類の権限付与、ゲートウェイでの認可チェックという、非常にシンプルで洗練された設計になっています。ユーザートークンは常に一定であり、動作するエージェントが切り替わり、すべてのツール呼び出しが「どのユーザーか」「どのエージェントか」という両方の問いに同時に答えます。これにより、自律型システムは単に動作するだけでなく、適切な監査が可能なシステムへと進化します。

すべてのエージェントにアイデンティティを付与し、誰が実際に各ツールを呼び出したかを可視化しましょう。

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
11月 20, 2026
|
5 min read

GPT-6.1 Terra: API、ベンチマーク、料金体系、使い方ガイド

No items found.
11月 20, 2026
|
5 min read

Machine Learningの進化:Savinの歩みを深く掘り下げる

True MLトーク
11月 20, 2026
|
5 min read

CrewAI vs LangGraph: 違いを知る

比較
11月 20, 2026
|
5 min read

すべてのリクエストを評価:Confident AIとTrueFoundry AI Gateway

No items found.
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour