はじめに
前回は、Microsoft Entra IDでAgent BlueprintとAgent IDを作成しました。
今回は、作成したAgent IDを使い、Microsoft Graph APIにアクセスするまでを検証します。
AIエージェントが企業のシステムにアクセスする際、重要になるのが認証(Authentication)と認可(Authorization)です。
今回のハンズオンでは、実際のAIエージェントを開発する代わりにPowerShellを利用して、これらの仕組みを検証しました。
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「LearningAgent01」として、トークンを取得したいです。
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. トークン取得の流れ
今回のハンズオンでは、次の3種類のトークンを取得しました。
| トークン | 役割 |
|---|---|
| T1 | Blueprintの認証情報から取得する交換用トークン |
| T2 | Agent IDを主体として取得する交換用トークン |
| Graph用トークン | Agent IDとしてMicrosoft Graphにアクセスするためのトークン |
処理の流れは以下のとおりです。
① Blueprintの認証情報 → T1取得
まず、BlueprintのクライアントIDとClient Secretを利用して、Entra IDからT1を取得します。
② T1 → T2取得
次にT1を認証情報として提示し、Agent IDのT2を取得します。
実際に取得したT2の azp(Authorized Party)を確認すると、LearningAgent01のApplication IDと一致していました。
これにより、Agent IDに対応したトークンが発行されたことを確認できました。
③ T1 → Graph用トークン取得
最後に、T1を利用してMicrosoft Graph向けのアクセストークンを取得します。
ここで重要なのは、今回のGraphアクセスではT2を使用していないことです。
T2はAgent IDのトークン交換の仕組みを理解するために取得しました。今回のようにAgent ID自身のアプリケーション権限でGraphにアクセスする場合、T1からGraph用トークンを取得できます。
なお、Agent Userの権限を利用する場合など、別の認証フローではT2を利用するケースがあります。
4. Graph用トークンを取得しても、アクセスできるとは限らない
Graph用トークンの取得に成功したため、次のAPIを呼び出しました。
GET https://graph.microsoft.com/v1.0/organization
これは、組織情報を取得するMicrosoft Graph APIです。
しかし、結果は次のとおりでした。
403 Forbidden(アクセス拒否)
なぜでしょうか。
理由は、認証と認可が別の仕組みだからです。
- 認証(Authentication):どのAgent IDとしてアクセスしているかを確認する
- 認可(Authorization):そのAgent IDに何の操作が許可されているかを確認する
今回、Agent IDとしての認証には成功していましたが、Graphの組織情報を読み取る権限がありませんでした。
実際にアクセストークンの中身を確認すると、権限情報を表す roles が空欄になっていました。
5. Agent IDにGraphのアクセス権限を付与する
そこで、LearningAgent01に以下の権限を付与しました。
Organization.Read.All
これは、Microsoft Graphを通じて組織情報を読み取るためのアプリケーション権限です。
今回、管理者アカウントからMicrosoft Graph PowerShellを使って権限を付与しました。
権限付与の考え方は非常にシンプルです。
Agent ID「LearningAgent01」に対して、Microsoft Graphの組織情報を読み取る権限を付与してください。
この操作を行う際には、次の3つを指定します。
| 指定項目 | 今回の設定 |
|---|---|
| principalId(誰に) | LearningAgent01 |
| resourceId(どのサービスに) | Microsoft Graph |
| appRoleId(何の権限を) | Organization.Read.All |
なお、権限はBlueprintではなく個々のAgent IDに付与しています。
そのため、同じBlueprintから作成された別のAgent IDに、自動的に同じGraph権限が付与されるわけではありません。
6. 権限付与後にGraph APIへ再アクセス
権限を付与した後、新しいGraph用アクセストークンを取得しました。
すると、トークンの roles に次の値が追加されていました。
Organization.Read.All
このトークンを使って、先ほどと同じGraph APIに再アクセスします。
今度は成功し、組織のIDと表示名を取得できました。
検証結果を整理すると、以下のとおりです。
| 検証項目 | 権限付与前 | 権限付与後 |
|---|---|---|
| Agent IDの認証 | 成功 | 成功 |
| Graph用トークン取得 | 成功 | 成功 |
| roles | 空欄 | Organization.Read.All |
| Graph APIアクセス | 403 Forbidden | 成功 |
今回の検証から、Agent IDとして認証に成功しても、適切なアクセス権限がなければAPIを利用できないことを確認できました。
また、権限付与後にはアクセストークンを再取得する必要があります。既存のトークンには、新たに付与した権限が自動的に追加されるわけではありません。
7. 不要になった権限を取り消す
ハンズオン終了後、Entra管理センターからLearningAgent01の Organization.Read.All を取り消しました。
今回はGUIの「アクセス許可の取り消し」を使用しています。
これにより、検証用に割り当てた権限を削除できました。
ただし、権限を取り消しても、既に発行されたアクセストークンは有効期限まで利用できる場合があるため注意が必要です。
まとめ
今回のハンズオンを通じて、Entra Agent IDの認証・認可の仕組みを確認できました。
特に重要なのは以下の4点です。
- Blueprintの認証情報を利用して、個別のAgent IDとしてトークンを取得できる。
- Agent IDは個別にアクセス権限を持ち、同じBlueprintの他のAgent IDとは権限を分離できる。
- 認証に成功しても、認可されていなければAPIへのアクセスは拒否される。
- 不要なアクセス権限は個別に取り消すことができる。
企業で多数のAIエージェントを利用する場合、エージェントごとに専用のIDを割り当て、必要最小限の権限を付与することが重要です。
Entra Agent IDは、そのための認証・認可の基盤となる仕組みだと理解できました。
次回は、Agent Blueprint、Blueprint Principal、Agent IDの構造と、それぞれの役割について詳しく整理します。

コメント