Microsoft FoundryエージェントからGraph APIにアクセスする際の認証・認可

1. Foundryエージェントの呼び出し

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

エージェントがSharePointやOutlookなどのMicrosoft 365リソースにアクセスする場合、Microsoft Graph APIを利用できます。

エージェントを呼び出すAPI(本記事ではAPI①とする)と、エージェントがリソースを操作する際に呼び出すAPI(Graph API、本記事ではAPI②とする)は別物という点です。

2. Graph API(API②)への2つのアクセス方式

方式アクセス権限
委任されたアクセス許可(Delegated)ユーザーの権限とアプリに付与されたアクセス許可の範囲
アプリケーションのアクセス許可(Application)アプリケーション自身に付与された権限の範囲

例えば、SharePointのファイルを読み取る場合、Delegatedではユーザー本人がアクセスできるファイルに限定されます。

一方、Applicationではユーザーの権限とは独立して、アプリケーションに許可された範囲でアクセスします。

3. Delegatedを実現するOBOフロー

OBO(On-Behalf-Of)とは、ユーザーの代理として別のAPIにアクセスするための認証フローです。

例えば、ユーザーAがWebアプリからFoundryエージェントを利用する場合、次のような流れになります。

  1. ユーザーAがWebアプリにサインインする。
  2. WebアプリがユーザーAのアクセストークンを取得し、エージェント側のバックエンドに渡す(ここで、API①が使われる)
  3. バックエンドがOBOフローを利用し、Graph API用のアクセストークンを取得する。
  4. 取得したトークンでGraph API(API②)にアクセスし、SharePointのファイルを読み取る。

OBOによって、ユーザーAの権限を引き継いだアクセスが可能になります。

ただし、WebアプリからFoundryエージェントをAPI(API①)で呼び出すだけでは、OBOは自動的に実行されません。

Foundryの対応する認証機能やバックエンド側での実装・設定が必要です。

コメント

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