Microsoft Foundryエージェントの認証を理解する ~Webアプリからの呼び出しとOBO~

1. はじめに

Microsoft Foundryで作成したAIエージェントは、独自のWebアプリからAPI経由で呼び出すことができます。

例えば、ユーザーがWebアプリから「私のSharePointファイルを検索して」と依頼し、FoundryエージェントがMicrosoft Graph APIを使って検索するケースです。

この仕組みを理解するには、3段階の認証・認可を区別する必要があります。

段階処理目的
①ユーザー → Webアプリユーザー本人の認証
②Webアプリ → Foundryエージェントを呼び出すための認証・認可
③Foundry → Graph APIユーザーの代理でアクセスするための認証・認可

今回は、Agent BlueprintとAgent IDを利用したOBO方式を中心に解説します。

2. WebアプリからFoundryを呼び出す

まず、ユーザーAがEntra IDを使って独自Webアプリにサインインします。

Webアプリは、Entra IDからFoundryエージェントを呼び出すためのアクセストークンを取得します。

Agent Blueprint認証方式では、例えば以下の委任権限を要求します。

api://<BlueprintのClient ID>/access_agent

このアクセストークンには、ユーザーAの情報や呼び出し先などが含まれます。

Webアプリは、このトークンを付けてFoundryエージェントのAPIを呼び出します。

Foundryはトークンを検証し、許可されたリクエストを処理します。

重要なのは、この時点ではGraph APIへのアクセス権限を取得したわけではないことです。

3. OBOとは何か?

OBO(On-Behalf-Of)は、ユーザーの代理として別のAPIにアクセスするためのアクセストークンを取得する仕組みです。

例えば、FoundryエージェントがユーザーAのSharePointファイルを検索する場合です。

対応するFoundryのユーザー委任機能では、概念的に次の流れになります。

  1. Webアプリが、ユーザーAのトークンを使ってFoundryエージェントを呼び出す。
  2. Foundry Agent Serviceが、ユーザーAのトークンとエージェントの認証情報を使い、Entra IDにGraph API向けトークンを要求する。
  3. Entra IDが、トークン、委任権限、同意などを検証する。
  4. Entra IDが、条件を満たしていればGraph API向けアクセストークンを発行する。
  5. Foundryエージェントが、ユーザーAの権限でGraph APIにアクセスする。

つまり、WebアプリがGraph API用トークンを取得しなくても、Foundry側でOBOによるトークン交換を実行できる構成があります。

ただし、これは対応する認証方式・ツールを利用する場合の動作であり、すべてのFoundryエージェントで自動的に利用できるわけではありません。

4. ユーザーへの権限同意は必要?

OBOでGraph APIの委任権限を使用する場合、権限への同意が必要です。

例えば、エージェントがFiles.Read権限を要求するケースです。

同意の状況によって動作が異なります。

状況動作
管理者が事前同意済み通常、ユーザーへの同意画面は不要
ユーザーが同意済み通常、再同意は不要
同意が未取得ユーザーまたは管理者による同意が必要

同意が不足している場合は、Webアプリ側で実装が必要

対応するFoundryの認証フローでは、同意が不足している場合、Foundry Agent ServiceがWebアプリのバックエンドにoauth_consent_requestを含む応答を返すことがあります。

重要なのは、Foundryがユーザーに同意画面を自動表示してくれるわけではないことです。

独自Webアプリの開発者は、以下の処理をWebアプリ側に実装する必要があります。

  1. Webアプリのバックエンドが、Foundryから返された同意要求情報を受け取る。
  2. Webアプリのフロントエンドが、ユーザーAに同意用リンクを表示する。
  3. ユーザーAが、Entra IDの画面で必要な権限に同意する。
  4. Webアプリが、同意完了後にエージェントの処理を再開する。

つまり、Foundryは同意が必要であることを通知しますが、同意画面への誘導や処理再開などはWebアプリ側で実装する必要があります。

なお、管理者同意が必要な権限については、ユーザーA自身では承認できません。

企業では、管理者が必要な委任権限に事前同意することで、ユーザーに同意画面を表示させない構成も考えられます。

5. まとめ

Microsoft Foundryの認証では、次の3点が重要です。

  • Webアプリの認証:ユーザーがWebアプリを利用するための認証
  • Foundryの認証:Webアプリがエージェントを呼び出すための認証
  • Graph APIの認証・認可:エージェントがユーザーの代理として業務データにアクセスするための仕組み

また、OBO方式では、ユーザーの権限を無条件にエージェントへ渡すわけではありません。

Entra IDによるトークン検証、委任権限、同意、ユーザー自身のデータアクセス権が関係します。

エージェントを呼び出す権限と、エージェントが業務データにアクセスする権限は別物である。

この点を理解することが、Foundryエージェントの認証・認可を理解する第一歩になります。


参考資料

コメント

タイトルとURLをコピーしました