Microsoft Entra Agent IDを理解する ~認証・認可とMicrosoft Graphへのアクセス

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 ××として、トークンを取得したいです。

エージェント(今回は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. トークン取得の流れ

トークン役割
T1Blueprintの認証情報から取得する交換用トークン
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に継承させることができます。

コメント

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