Microsoft Entra Agent IDを理解する② ~認証・認可とMicrosoft Graphへのアクセスをハンズオンで学ぶ~

はじめに

前回は、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 GraphMicrosoft 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 SecretBlueprintの認証情報

重要なのは、Agent ID自身のパスワードを使用しているわけではないことです。

Blueprintの認証情報を利用して、Agent IDとしてトークンを取得する仕組みになっています。

なお、本番環境ではClient Secretよりも、マネージドIDとフェデレーション資格情報など、長期間有効なシークレットを保持しない認証方式が望まれます。

3. トークン取得の流れ

今回のハンズオンでは、次の3種類のトークンを取得しました。

トークン役割
T1Blueprintの認証情報から取得する交換用トークン
T2Agent 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点です。

  1. Blueprintの認証情報を利用して、個別のAgent IDとしてトークンを取得できる。
  2. Agent IDは個別にアクセス権限を持ち、同じBlueprintの他のAgent IDとは権限を分離できる。
  3. 認証に成功しても、認可されていなければAPIへのアクセスは拒否される。
  4. 不要なアクセス権限は個別に取り消すことができる。

企業で多数のAIエージェントを利用する場合、エージェントごとに専用のIDを割り当て、必要最小限の権限を付与することが重要です。

Entra Agent IDは、そのための認証・認可の基盤となる仕組みだと理解できました。

次回は、Agent Blueprint、Blueprint Principal、Agent IDの構造と、それぞれの役割について詳しく整理します。

コメント

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