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

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

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

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

ここで重要なのは、エージェントを呼び出す認証と、エージェントがGraph APIにアクセスする認証は別物という点です。

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

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

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

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

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

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

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

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

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

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

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

4. まとめ

FoundryエージェントからGraph APIにアクセスする場合、DelegatedとApplicationの2つの認可方式があります。

特にDelegatedでは、OBOフローによってユーザーの代理としてGraph APIにアクセスできることが重要です。

これにより、ユーザーごとのアクセス権限を維持しながら、AIエージェントにMicrosoft 365のリソースを操作させることができます。

コメント

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