1. 関連用語
目的は、Agent ID「LearningAgent01」として認証し、Microsoft Graphから組織情報を取得することです。
登場する主な要素は以下のとおりです。
| 要素 | 役割 |
|---|---|
| Agent Blueprint | エージェントのIDを作成するための基盤。認証情報を保持 |
| Agent ID | 個々のAIエージェントを識別するID |
| Microsoft Entra ID | 認証とアクセストークンの発行 |
| Microsoft Graph | Microsoft 365などの情報にアクセスするAPI |
| PowerShell | 今回はAIエージェントの代わりに認証・API要求を実行 |
ポイントは、BlueprintとAgent IDの役割が異なることです。
エージェントは、Blueprintの認証情報を利用して、Agent IDとして動作するためのトークンを取得します。
2. Agent IDとして認証する仕組み
今回の認証処理を、エージェント目線で、かみ砕いて表現すると以下のようになります。
私(エージェント)はBlueprint Aの認証情報を持っています。そのBlueprintから作成されたAgent ID ××として、トークンを取得したいです。
エージェント(今回はPowershellアプリで代替した)からEntra IDに、この要求を送信します。
Entra IDは認証情報やAgent IDとの関連を検証し、問題がなければアクセストークンを発行します。
認証に必要な4つの情報
| 情報 | 意味 |
|---|---|
| Tenant ID | どの組織で認証するか |
| Blueprint Client ID | どのBlueprintを利用するか |
| Agent ID Client ID | どのエージェントとして動作するか |
| Client Secret | Blueprintの認証情報 |
ポイントは、Agent ID自身のパスワードを使用しているわけではないことです。
Blueprintの認証情報を利用して、Agent IDとしてトークンを取得する仕組みになっています。
本番環境ではClient Secretよりも、マネージドIDとフェデレーション資格情報など、長期間有効なシークレットを保持しない認証方式を使うのが良いです。
3. トークン取得の流れ
| トークン | 役割 |
|---|---|
| T1 | Blueprintの認証情報から取得する交換用トークン |
| T2(参考) | Agent IDを主体として取得する交換用トークン |
| Graph用トークン | Agent IDとしてMicrosoft Graphにアクセスするためのトークン |
処理の流れは以下のとおりです。
① Blueprintの認証情報 → T1取得
まず、BlueprintのクライアントIDとClient Secretを利用して、Entra IDからT1を取得します。
② T1 → Graph用トークン取得
T1を利用してMicrosoft Graph向けのアクセストークンを取得します。
なお、Agent Userの権限を利用する場合など、別の認証フローではT2を利用するケースがあります。
4. Graph用トークンを取得しても、アクセスできるとは限らない
ここまでが、認証です。
追加で認可の設定が必要です。
- 認証(Authentication):どのAgent IDとしてアクセスしているかを確認する
- 認可(Authorization):そのAgent IDに何の操作が許可されているかを確認する
エージェントIDに直接アクセス権を付与したり、ブループリントにアクセス権を付与してそれをエージェントIDに継承させることができます。

コメント