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のユーザー委任機能では、概念的に次の流れになります。
- Webアプリが、ユーザーAのトークンを使ってFoundryエージェントを呼び出す。
- Foundry Agent Serviceが、ユーザーAのトークンとエージェントの認証情報を使い、Entra IDにGraph API向けトークンを要求する。
- Entra IDが、トークン、委任権限、同意などを検証する。
- Entra IDが、条件を満たしていればGraph API向けアクセストークンを発行する。
- 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アプリ側に実装する必要があります。
- Webアプリのバックエンドが、Foundryから返された同意要求情報を受け取る。
- Webアプリのフロントエンドが、ユーザーAに同意用リンクを表示する。
- ユーザーAが、Entra IDの画面で必要な権限に同意する。
- Webアプリが、同意完了後にエージェントの処理を再開する。
つまり、Foundryは同意が必要であることを通知しますが、同意画面への誘導や処理再開などはWebアプリ側で実装する必要があります。
なお、管理者同意が必要な権限については、ユーザーA自身では承認できません。
企業では、管理者が必要な委任権限に事前同意することで、ユーザーに同意画面を表示させない構成も考えられます。
5. まとめ
Microsoft Foundryの認証では、次の3点が重要です。
- Webアプリの認証:ユーザーがWebアプリを利用するための認証
- Foundryの認証:Webアプリがエージェントを呼び出すための認証
- Graph APIの認証・認可:エージェントがユーザーの代理として業務データにアクセスするための仕組み
また、OBO方式では、ユーザーの権限を無条件にエージェントへ渡すわけではありません。
Entra IDによるトークン検証、委任権限、同意、ユーザー自身のデータアクセス権が関係します。
エージェントを呼び出す権限と、エージェントが業務データにアクセスする権限は別物である。
この点を理解することが、Foundryエージェントの認証・認可を理解する第一歩になります。
参考資料


コメント