この記事は「AI AgentとIdentity」連載の第6回です。前回はGovernance / Lifecycleを扱いました。今回は、Microsoft Entra Agent IDのAgent Identityを棚卸しする方法を、実機で確認しながら整理します。
検証条件:検証用テナント(Agent Identityは1件)で、グローバル管理者の委任トークンを使って実行しました。Agent Identityは第2回でMicrosoft Graph APIから作成したものです。APIの仕様や権限要件は変更される可能性があるため、実行前に最新の公式ドキュメントを確認してください。
はじめに
AI Agentの数が増えてくると、認証方式だけでなく、**「どのAgentが存在し、誰が管理し、どの権限を持つのか」**を説明できることが重要になります。
例えば、社内で100個のAgentが稼働しているとします。
- Agent Identityは何個あるのか?
- OwnerとSponsorは誰か?
- Microsoft GraphのApplication Permissionは何が付与されているか?
- Blueprintから権限を継承していないか?
- Microsoft Entraロールが割り当てられていないか?
- 利用状況を確認できるか?
これらを管理画面で一つずつ確認するのは現実的ではありません。そこで今回は、Microsoft GraphとPowerShellを使って、Agent Inventory(管理台帳)を作ります。
なお、検証中にSponsor取得APIで公式リファレンスの記載と異なる挙動を確認しました。委任スコープを変えた追加検証の結果も、6章で紹介します。
1. 今回のゴールと対象範囲
作成する管理台帳の項目は以下です。
| 項目 | 意味 | 今回の扱い |
|---|---|---|
| AgentId / AgentName | Agent Identityの識別 | 一覧APIから取得 |
| BlueprintId | 紐づくBlueprint | 一覧APIから取得 |
| AccountEnabled | 有効・無効 | 一覧APIから取得 |
| CreatedDateTime | 作成日時 | 一覧APIから取得 |
| Owner | 技術的な管理主体 | 専用APIで取得 |
| Sponsor | 責任主体 | 専用APIで取得(権限に注意) |
| DirectAppRoles | 直接付与されたアプリロール |
appRoleAssignments を参照 |
| InheritedPermissions | Blueprint由来の権限 | 今回は未実装 |
| EntraRoles | ディレクトリロール | 今回は未実装 |
| LastActivity | 最終利用状況 | 今回は未実装 |
| CollectionStatus | 情報の取得状況 | 未取得とゼロ件を区別 |
対象はMicrosoft Entra Agent IDのAgent Identityです。 通常のアプリ登録、Managed Identity、Foundry / Copilot StudioのすべてのAgentを網羅するものではありません。これらを含めた全社AI Agent台帳を作るには、各プラットフォームのインベントリ情報との突合が必要です。
2. 構成イメージ
Microsoft Entra ID
└─ Agent Identity / Blueprint / Service Principal
│
▼
Microsoft Graph
│
▼
PowerShell 7
├─ Agent一覧取得
├─ Owner / Sponsor取得
├─ Application Permission取得
├─ 権限名への変換
└─ 取得失敗・未対応の記録
│
▼
AgentInventory.csv
│
▼
セキュリティレビュー
本番運用では、取得用のアプリケーション認証、定期実行、ログ監視、差分比較を組み合わせます。まずは検証環境で読み取りを中心にした棚卸しを実装します。
3. 事前準備
PowerShell 7を用意し、Microsoft Graph PowerShell SDKの認証モジュールをインストールします。
Install-Module Microsoft.Graph.Authentication -Scope CurrentUser
Import-Module Microsoft.Graph.Authentication
Agent Identityの一覧取得に必要な権限は、委任・アプリケーションともAgentIdentity.Read.Allです(上位はAgentIdentity.ReadWrite.All)。
Connect-MgGraph -Scopes "AgentIdentity.Read.All", "Application.Read.All"
Get-MgContext | Select-Object TenantId, Account, Scopes
なお、6章の権限切り分けでは、上記とは別に専用のアプリ登録を用意し、スコープを限定した委任トークンで検証しています。
APIごとに必要なGraph権限は異なります。このスコープだけで、Owner、Sponsor、アプリロール、ロール割り当て、サインインログのすべてが取得できるわけではありません。
また、公式ドキュメントによると、Blueprintやその主体を作成した人は自動的にOwnerになります。Ownerではないユーザーが委任権限でこのAPIを呼ぶ場合は、Agent ID Administratorなどのロールが必要です。スコープへ同意しただけでは取得できないことがあります。
4. Agent Identityを一覧取得する
Agent Identity専用の一覧APIを使用します。
GET https://graph.microsoft.com/v1.0/servicePrincipals/microsoft.graph.agentIdentity
このAPIは、Agent Identity以外のService Principalを返しません。
ページサイズは既定・最大とも100件なので、Agentが100を超えるテナントでは@odata.nextLinkをたどらないと取りこぼします。
function Get-GraphCollection {
param([Parameter(Mandatory)][string]$Uri)
$items = [System.Collections.Generic.List[object]]::new()
while ($Uri) {
# 非終了エラーも呼び出し側の catch で扱えるように Stop を指定する
$response = Invoke-MgGraphRequest -Method GET -Uri $Uri -ErrorAction Stop
foreach ($item in @($response.value)) {
if ($null -ne $item) { $items.Add($item) }
}
$Uri = $response.'@odata.nextLink'
}
return $items.ToArray()
}
$baseUrl = 'https://graph.microsoft.com/v1.0'
$agents = @(Get-GraphCollection -Uri "$baseUrl/servicePrincipals/microsoft.graph.agentIdentity")
$agents |
Select-Object id, displayName, agentIdentityBlueprintId, accountEnabled, createdDateTime |
Format-Table -AutoSize
実測:実際に返ってきたプロパティ
検証テナントで実行すると、1件のAgent Identityが返り、次のプロパティが含まれていました。
accountEnabled, agentIdentityBlueprintId, appRoleAssignmentRequired,
createdByAppId, createdDateTime, disabledByMicrosoftStatus,
displayName, id, servicePrincipalType, tags
| プロパティ | 実測値(マスク済み) | 棚卸しでの使い道 |
|---|---|---|
displayName |
TokenTestAgent |
Agentの識別 |
agentIdentityBlueprintId |
524def2c… |
どのBlueprint配下か |
accountEnabled |
True |
有効・無効 |
createdDateTime |
2026-09-15T16:37:48Z |
いつ作られたか(放置Agentの検出に使える) |
createdByAppId |
(GUID) | どのアプリが作成したか |
servicePrincipalType |
ServiceIdentity |
Agent Identityであることの確認 |
disabledByMicrosoftStatus |
null |
Microsoft側で無効化されていないか |
servicePrincipalTypeがServiceIdentityになっている点は、通常のService Principalと区別するうえで分かりやすい指標です。
5. Ownerを取得する
Agent IdentityのOwnerは専用のナビゲーションAPIで取得します。
GET /servicePrincipals/{id}/microsoft.graph.agentIdentity/owners
必要な権限は次のとおりです。
| 権限の種類 | 最小権限 | 上位の権限 |
|---|---|---|
| 委任(職場・学校アカウント) | AgentIdentity.Read.All |
Application.Read.All |
| アプリケーション |
AgentIdentity.Read.All、AgentIdentity.CreateAsManager
|
Application.Read.All |
委任では、一覧取得と同じAgentIdentity.Read.Allで取得できます(今回の検証もこの経路です)。
アプリケーション権限の欄は、公式リファレンスに記載された権限候補をそのまま示しています。
今回の検証では委任権限しか使っていないため、各権限の単独利用や組み合わせについては確認していません。アプリケーション権限で実装する場合は、実際に付与して確認してください。
$ownerResults = foreach ($agent in $agents) {
$uri = "$baseUrl/servicePrincipals/$($agent.id)/microsoft.graph.agentIdentity/owners"
try {
$owners = @(Get-GraphCollection -Uri $uri)
[pscustomobject]@{
AgentId = $agent.id
OwnerCount = $owners.Count
OwnerIds = ($owners | ForEach-Object { $_.id }) -join ';'
OwnerStatus = 'Success'
}
}
catch {
[pscustomobject]@{
AgentId = $agent.id
OwnerCount = $null
OwnerIds = $null
OwnerStatus = "Error: $($_.Exception.Message)"
}
}
}
実測:Ownerが0件のAgentが見つかった
検証テナントでは、APIは成功したもののOwnerは0件でした。
このAgent Identityは、第2回でMicrosoft Graph APIから作成したものです。作成時にSponsorだけを指定し、Ownerを指定していませんでした。
第5回で整理したとおり、Sponsorは必須ですがOwnerは任意です。そのため、作成方法によってはOwnerが空のまま運用に入ることがあります。
棚卸しで最初に検出したいのは、まさにこの状態です。
重要なのは、取得に失敗したAgentを「Ownerなし」と扱わないことです。OwnerCount = 0(Ownerが設定されていない)とOwnerStatus = Error(確認できていない)は意味が異なります。
6. Sponsorの取得は権限要件に注意する
SponsorはOwnerとは異なる責任主体を表します。取得APIは次のとおりです。
GET /servicePrincipals/{id}/microsoft.graph.agentIdentity/sponsors
公式リファレンスに記載されている権限は、Ownerと大きく異なります。
| 権限の種類 | Owner一覧 | Sponsor一覧(ドキュメントの記載) |
|---|---|---|
| 委任(職場・学校アカウント) | AgentIdentity.Read.All |
サポートされない |
| アプリケーション |
AgentIdentity.Read.All ほか |
AgentIdentity.ReadWrite.Allのみ |
アプリケーション権限で取得する場合、読み取り専用の権限は用意されていません。棚卸し(読み取り)のために、Agent Identityを作成・変更できる権限が必要になります。
実測:委任トークンでも取得できた
検証テナントで、グローバル管理者の委任トークンを使って呼び出したところ、200が返り、Sponsorを1件取得できました。
ドキュメントの「委任はサポートされない」という記載とは、結果が一致しませんでした。
切り分け1:ReadWrite.AllがなくてもSponsorを取得できた
最初の検証で使ったトークンには、過去に同意したAgentIdentity.ReadWrite.Allも含まれていました。
そこで、AgentIdentity.Read.Allだけを管理者同意した専用のアプリ登録を作り、そのアプリでサインインして再検証しました。
取得したトークンのスコープは次のとおりです。
scp = AgentIdentity.Read.All profile openid email
このスコープを限定したトークンでの結果です(実行ユーザーはグローバル管理者のままです)。
| API | 結果 |
|---|---|
| Agent Identity 一覧 | OK(1件) |
| Owner 取得 | OK(0件) |
| Sponsor 取得 | OK(1件) |
appRoleAssignments 取得 |
OK(1件) |
Sponsorは、AgentIdentity.ReadWrite.Allがなくても取得できました。
さらに、appRoleAssignmentsもApplication.Read.Allを持たないトークンで取得できています。
切り分け2:管理者ロールだけでは、今回の4つのAPIは通らなかった
次に、「グローバル管理者だから通ったのでは?」を確かめます。
Microsoft GraphのUser.Readだけを要求するアプリ登録を作り、AgentIdentity系のスコープを一切持たないトークンで同じAPIを呼びました。
aud = https://graph.microsoft.com
scp = User.Read profile openid email
実行者は同じグローバル管理者です。結果はすべて失敗でした。
| API | 結果 |
|---|---|
| Agent Identity 一覧 | 403 Authorization_RequestDenied |
| Owner 取得 | 403 Authorization_RequestDenied |
| Sponsor 取得 | 403 Authorization_RequestDenied |
appRoleAssignments 取得 |
403 Authorization_RequestDenied |
同じユーザー・同じロールでも、スコープを変えると結果が変わりました。少なくとも今回の4つのAPIでは、管理者ロールを持っているだけでは通りません。
Sponsor APIの検証マトリクス
| 委任スコープ | 実行ユーザーのロール | 実測 |
|---|---|---|
AgentIdentity.Read.All |
グローバル管理者 | 200 OK |
スコープなし(User.Readのみ) |
グローバル管理者 | 403 Forbidden |
AgentIdentity.Read.All |
Global Reader | 未検証 |
AgentIdentity.Read.All |
ロールなしの一般ユーザー | 未検証 |
AgentIdentity.ReadWrite.All(アプリケーション) |
- | 未検証 |
結論と、残る未確認
今回の検証環境で確認できたのは、次の2点です。
- グローバル管理者が
AgentIdentity.Read.Allの委任スコープを持つトークンを使った場合、Sponsorを取得できた(AgentIdentity.ReadWrite.Allは不要だった) - 同じ管理者でも、
User.Readだけのトークンでは403だった
比較した2種類のトークンで結果が分かれたことから、スコープの違いが効いていると考えられます。
ただし、ロールを持たないユーザーでも成功するかは未検証です。スコープだけで足りるのか、スコープとロールの組み合わせが必要なのかまでは分かりません。
いずれにせよ、公式リファレンスは「委任はサポートされない」としているのに、実際には委任スコープで取得できている、という点は変わりません。
これは「委任でも使える」という意味ではありません。
ロールを持たない一般ユーザーでの検証は行っていないため、スコープだけで足りるのか、スコープ+ロールの組み合わせが必要なのかは分かりません。
参考までに、Owner一覧のリファレンスには、委任アクセスで利用できるビルトインロール(Global Reader、Directory Readers、Cloud Application Administratorなど)が列挙されています。
ドキュメントに「サポートされない」と書かれている経路は、サポート対象外です。依存した実装は仕様変更で動かなくなる可能性があります。
本番の棚卸しでは、ドキュメントに記載された経路(アプリケーション権限)を前提に設計し、AgentIdentity.ReadWrite.Allを持つ取得専用のアプリを分離するのが安全です。
$sponsorResults = foreach ($agent in $agents) {
$uri = "$baseUrl/servicePrincipals/$($agent.id)/microsoft.graph.agentIdentity/sponsors"
try {
$sponsors = @(Get-GraphCollection -Uri $uri)
[pscustomobject]@{
AgentId = $agent.id
SponsorCount = $sponsors.Count
SponsorIds = ($sponsors | ForEach-Object { $_.id }) -join ';'
SponsorStatus = 'Success'
}
}
catch {
[pscustomobject]@{
AgentId = $agent.id
SponsorCount = $null
SponsorIds = $null
SponsorStatus = "Error: $($_.Exception.Message)"
}
}
}
7. Application Permissionを取得する
Application Permissionの割り当ては、Service PrincipalのappRoleAssignmentsから確認します。
GET /servicePrincipals/{id}/appRoleAssignments
公式ドキュメントでは、このAPIにApplication.Read.Allなどの読み取り権限が必要とされています。
今回の検証では、6章でスコープを限定したトークン(AgentIdentity.Read.Allのみ、実行者はグローバル管理者)でも取得できました。
一方、User.Readだけのトークンでは、同じ管理者でも403になります。こちらもスコープが効いている点はSponsorと同じです。
本番では、ドキュメントどおりの権限を付与して設計してください。
$permissionResults = foreach ($agent in $agents) {
$uri = "$baseUrl/servicePrincipals/$($agent.id)/appRoleAssignments"
try {
$assignments = @(Get-GraphCollection -Uri $uri)
[pscustomobject]@{
AgentId = $agent.id
AssignmentCount = $assignments.Count
Assignments = $assignments
PermissionStatus = 'Success'
}
}
catch {
[pscustomobject]@{
AgentId = $agent.id
AssignmentCount = $null
Assignments = @()
PermissionStatus = "Error: $($_.Exception.Message)"
}
}
}
appRoleIdを権限名に変換する
ここで得られるappRoleIdはGUIDです。User.Read.Allのような表示名にするには、**割り当て先リソースのService Principalが持つappRoles**と照合します。
$roleNameCache = @{}
function Resolve-AppRoleName {
param([string]$ResourceId, [string]$AppRoleId)
if (-not $roleNameCache.ContainsKey($ResourceId)) {
$roleNameCache[$ResourceId] = Invoke-MgGraphRequest -Method GET `
-Uri "$baseUrl/servicePrincipals/$ResourceId`?`$select=displayName,appRoles" `
-ErrorAction Stop
}
$sp = $roleNameCache[$ResourceId]
# 想定外に複数一致した場合は曖昧なまま返さず、呼び出し側で未解決として扱わせる
$role = @($sp.appRoles | Where-Object { [string]$_.id -eq $AppRoleId })
if ($role.Count -ne 1) {
throw "AppRole resolution failed: resourceId=$ResourceId appRoleId=$AppRoleId (matched $($role.Count))"
}
[pscustomobject]@{
ResourceName = $sp.displayName
AppRoleValue = $role[0].value
}
}
この関数は、リソースのService Principalを取得できないと例外になります。
Agentが多いテナントでは、1件の解決失敗で棚卸し全体が止まらないよう、呼び出し側でtry/catchし、解決できなかった割り当ては「未解決」として記録してください(9章のコードを参照)。
検証テナントで実行すると、次のように変換できました。
resource='Microsoft Graph' appRole='User.Read.All'
Microsoft Graph以外のAPIに対する権限も混在し得るため、resourceIdを無視して権限名を決めないようにします。
また、この結果は直接確認できるアプリロール割り当てです。Delegated Permission、Blueprintから継承する権限、実際に発行されたトークンの権限をすべて表すものではありません。
Blueprintの継承権限は別途確認する
第3回・第5回で扱ったとおり、Agent IdentityにはBlueprintからの権限継承(inheritable permissions)があります。直接割り当てが空でも、利用可能な権限がないとは限りません。
実際、第2回の検証では、BlueprintにDelegated PermissionのUser.Readを同意して継承させており、OBOで取得したトークンのscpにその権限が入っていました。しかし、今回のappRoleAssignmentsにはその情報は現れません。
検証では以下を比較します。
- Agent Identityの直接割り当て
- Blueprint側で設定・承認された権限と継承設定
- 対象API向けに発行されたトークンの
roles/scp
継承権限の完全な列挙方法は、今回のスクリプトでは未実装です。 「直接割り当てゼロ=権限ゼロ」と判定しないことが重要です。
8. Entraロールと利用履歴はどう扱うか
Microsoft Entraロールは、Microsoft GraphのroleManagement/directory系APIでロール割り当てとロール定義を取得し、Agent IdentityのオブジェクトIDと突き合わせる方法が考えられます。
GET /roleManagement/directory/roleAssignments
ただし、割り当てスコープやPIMによる適格性など、追加の確認が必要になる場合があります。単一APIの結果だけで実効的な管理権限を断定しないようにします。
また、サインインログについても、Agent Identityに対応するログ種別、API、保持期間を確認する必要があります。
| 状況 | 台帳での表現 |
|---|---|
| 観測期間内に利用記録あり | 利用あり |
| 観測期間内に利用記録なし | 観測期間内の利用なし |
| ログ保持期間が不足 | 判定不能 |
| ログ取得権限がない | 取得失敗 |
「ログが見つからない=90日間未使用」とは判定できません。 90日間の判定には、少なくともその期間を網羅するログが必要です。
この2つは、今回のスクリプトでは未実装として台帳に記録します。
9. CSVを作成する
ここまでの結果を結合します。継承権限、Entraロール、利用履歴は未取得であることを明示します。
まず、目視レビューの対象にしたい権限を定義しておきます。
# 「危険な権限」の定義ではなく、人の目で確認したい権限のリスト
# 同名のアプリロールが別リソースにも存在し得るため、リソース名まで含めて判定する
$reviewPermissions = @(
'Microsoft Graph/User.Read.All',
'Microsoft Graph/Directory.Read.All',
'Microsoft Graph/Directory.ReadWrite.All',
'Microsoft Graph/RoleManagement.ReadWrite.Directory'
)
このリストは例です。権限の強さは、Application / Delegatedの別、対象リソースの範囲、業務上の必要性によって変わります。
リストに載っているから危険、載っていないから安全、と機械的に判断しないでください。
$ownerById = @{}
foreach ($item in $ownerResults) { $ownerById[$item.AgentId] = $item }
$permissionById = @{}
foreach ($item in $permissionResults) { $permissionById[$item.AgentId] = $item }
$sponsorById = @{}
foreach ($item in $sponsorResults) { $sponsorById[$item.AgentId] = $item }
$inventory = foreach ($agent in $agents) {
$owner = $ownerById[$agent.id]
$permission = $permissionById[$agent.id]
$sponsor = $sponsorById[$agent.id]
$flags = [System.Collections.Generic.List[string]]::new()
if ($owner.OwnerStatus -eq 'Success' -and $owner.OwnerCount -eq 0) { $flags.Add('OwnerMissing') }
if ($owner.OwnerStatus -ne 'Success') { $flags.Add('OwnerUnknown') }
if ($sponsor.SponsorStatus -ne 'Success') { $flags.Add('SponsorUnknown') }
if ($permission.PermissionStatus -ne 'Success') { $flags.Add('DirectPermissionUnknown') }
# 割り当ての「取得」と、権限名への「解決」は別の状態として扱う
$roleNames = @()
$resolutionStatus = 'NotApplicable'
if ($permission.PermissionStatus -eq 'Success') {
$resolutionStatus = 'Success'
foreach ($a in $permission.Assignments) {
try {
$resolved = Resolve-AppRoleName -ResourceId $a.resourceId -AppRoleId $a.appRoleId
$roleNames += "$($resolved.ResourceName)/$($resolved.AppRoleValue)"
}
catch {
# リソースのSPを取得できない、appRoleが見つからない、複数一致した場合
# 後から調査できるよう resourceId も残す
$roleNames += "Unresolved:$($a.resourceId)/$($a.appRoleId)"
$resolutionStatus = 'Partial'
}
}
if ($resolutionStatus -eq 'Partial') { $flags.Add('PermissionNameResolutionFailed') }
# レビュー対象にしたい権限が含まれていたらフラグを立てる
if (@($roleNames | Where-Object { $_ -in $reviewPermissions }).Count -gt 0) {
$flags.Add('PermissionReviewRequired')
}
}
[pscustomobject]@{
AgentId = $agent.id
AgentName = $agent.displayName
BlueprintId = $agent.agentIdentityBlueprintId
AccountEnabled = $agent.accountEnabled
CreatedDateTime = $agent.createdDateTime
OwnerCount = $owner.OwnerCount
OwnerIds = $owner.OwnerIds
OwnerStatus = $owner.OwnerStatus
SponsorCount = $sponsor.SponsorCount
SponsorIds = $sponsor.SponsorIds
SponsorStatus = $sponsor.SponsorStatus
DirectAppRoleCount = $permission.AssignmentCount
DirectAppRoles = ($roleNames -join ';')
AssignmentCollectionStatus = $permission.PermissionStatus
PermissionResolutionStatus = $resolutionStatus
InheritedPermissionStatus = 'NotEvaluated'
EntraRoleStatus = 'NotCollected'
ActivityStatus = 'NotCollected'
RiskFlags = ($flags -join ';')
}
}
# utf8BOM は PowerShell 7 以降で指定できます
$inventory | Export-Csv -Path './AgentInventory.csv' -NoTypeInformation -Encoding utf8BOM
実測:出力された内容
検証テナントでは、次の1行が出力されました(IDはマスクしています)。
| 項目 | 値 |
|---|---|
| AgentName | TokenTestAgent |
| BlueprintId | 524def2c… |
| AccountEnabled | True |
| CreatedDateTime | 2026-09-15T16:37:48Z |
| OwnerCount | 0 |
| OwnerIds | (空) |
| SponsorCount | 1 |
| SponsorIds |
c061bc60…(検証ユーザーのオブジェクトID) |
| DirectAppRoleCount | 1 |
| DirectAppRoles | Microsoft Graph/User.Read.All |
| AssignmentCollectionStatus | Success |
| PermissionResolutionStatus | Success |
| InheritedPermissionStatus | NotEvaluated |
| RiskFlags | OwnerMissing;PermissionReviewRequired |
AssignmentCollectionStatus(割り当てを取得できたか)とPermissionResolutionStatus(GUIDを権限名に解決できたか)は、別の状態として記録します。
割り当ては取得できたのに権限名だけ解決できない、という部分成功が起こり得るためです。
Agentが1件でも、Ownerが未設定のAgent Identityに、Microsoft GraphのUser.Read.All(Application Permission)が直接割り当てられていることを、台帳の1行で確認できました。
User.Read.Allは$reviewPermissionsに含めているため、PermissionReviewRequiredも立っています。
なお、この章で確認したのは割り当ての有無です。実際にそのトークンでAPIを呼べるかどうかは、第2回で扱ったトークンの発行まで含めて確認する必要があります。
この表は、本記事に掲載している最終版のコード(例外処理・状態の分離・レビュー対象フラグを含む)で再実行した結果です。
10. 今回の検証でできたこと・できなかったこと
| No. | 検証項目 | 結果 |
|---|---|---|
| 1 | v1.0のエンドポイントでAgent Identityを一覧取得 | ✅ 成功(1件、1ページ) |
| 2 | 返却プロパティの確認 | ✅ 10個のプロパティを確認 |
| 3 | Ownerの取得 | ✅ 成功(0件) |
| 4 | OwnerMissingの検出 | ✅ 実際に検出 |
| 5 | Sponsorの取得(委任トークン) | ⚠️ 成功。ドキュメントの記載と不一致 |
| 6 | Sponsorの取得(AgentIdentity.Read.Allのみ) |
⚠️ 成功。ReadWrite.Allは不要と判明 |
| 6b | Sponsorの取得(User.Readのみ・管理者) |
✅ 403。ロールだけでは通らないと確認 |
| 7 | appRoleAssignmentsの取得 | ✅ 成功(1件) |
| 8 | appRoleIdから権限名への変換 | ✅ Microsoft Graph/User.Read.All に変換 |
| 9 | CSVの生成 | ✅ 成功 |
| 10 | 100件を超えるページング | ⬜ 未検証(テナントに1件のみ。1ページのみ実測) |
| 11 | ロールを持たない一般ユーザーでの動作 | ⬜ 未検証(すべてグローバル管理者で実行) |
| 11b | アプリケーション権限での動作 | ⬜ 未検証(すべて委任権限で実行) |
| 12 | 権限不足時のOwnerUnknown判定 | ⬜ 未検証 |
| 13 | 権限名の解決失敗時の部分成功 | ⬜ 未検証(コードでは対応済み) |
| 14 | Blueprint継承権限の列挙 | ⬜ 未実装 |
| 15 | Entraロールの突合 | ⬜ 未実装 |
| 16 | 利用履歴の取得 | ⬜ 未実装 |
| 17 | 429・一時障害時の再試行 | ⬜ 未検証 |
今回の実測は、すべてグローバル管理者で実行しています。
AgentIdentity.Read.Allのみのトークンでも動作することは確認しましたが、ロールを持たない一般ユーザーや、アプリケーション権限での動作は検証していません。
本番では、実際に使う主体と権限で再確認してください。
未検証・未実装の項目は、次回以降で扱います。
11. 本番運用へ展開する場合の注意点
APIの権限を分離する
Agent一覧、Owner、Sponsor、アプリロール、ディレクトリロール、ログの取得では必要権限が異なります。
特にSponsorは、ドキュメント上は読み取りのためにAgentIdentity.ReadWrite.Allが必要です。全処理を単一の高権限アプリで実行するのではなく、収集処理と認証主体を分離します。
取得エラーを握りつぶさない
権限不足、429、タイムアウト、API未対応を区別し、台帳の項目に取得状態を残します。429ではRetry-Afterを尊重し、再試行上限と監視を設けます。
台帳自体を保護する
Agent名、Owner、付与権限の一覧は攻撃者にも有用な情報です。CSVの保存先、閲覧権限、保管期間を設計し、公開用サンプルには実テナントのIDやユーザー情報を含めないようにします。
差分を監視する
定期的に台帳を取得して、次の変化を検出します。
- 新規Agentの作成
- Owner / Sponsorの変更
- 新しいApplication Permissionの付与
- Blueprintとの関連変更
- 無効化・削除
ただし、差分検出は誤検知やAPI取得失敗を考慮して実装し、即時の自動削除・権限剥奪に直結させないようにします。
12. まとめ
今回は、Microsoft Entra Agent IDのAgent IdentityをMicrosoft Graphから棚卸ししました。
- Agent Identityの一覧だけでは全社のAI Agentを網羅できない:通常のService PrincipalやManaged Identityを使うAgentは別途確認が必要です。
-
直接付与された権限だけでは実効権限を断定できない:実際、第2回でBlueprintから継承させたDelegated Permissionは、
appRoleAssignmentsには現れませんでした。 -
Sponsorの取得は権限要件が特殊:ドキュメント上、委任はサポート対象外で、アプリケーション権限も
AgentIdentity.ReadWrite.Allしかありません。実測ではAgentIdentity.Read.Allの委任トークンで取得でき、スコープなしでは管理者でも403でした。ただし記載と一致しない経路なので、依存した実装は避けるべきです。 -
「情報がない」と「取得できなかった」を区別する:
OwnerCount = 0とOwnerStatus = Errorはまったく意味が違います。 - Ownerは任意なので、空のまま運用に入りやすい:今回の検証でも、Graph APIから作成したAgentはOwnerが0件でした。棚卸しで最初に見つけたいのはここです。
AI AgentのZero Trust運用では、認証方式の選定に加えて、誰が管理し、どの権限を使えるのかを継続的に説明できることが求められます。
今回のAgent Inventoryは、そのための出発点です。
次回予告
【第7回】Agent Identityの権限変更を検出する ― Microsoft Graphで継続的なPermission Monitoringを考える
次回は今回のInventoryを基に、前回との差分から権限追加・Owner変更・新規Agentを検出し、管理者レビューにつなげる方法を検討します。
あわせて、今回未実装だったBlueprintの継承権限の列挙にも取り組む予定です。
連載の予定
- 概念編:Delegated / Application / OBO
- Token実測編:
scp/roles/oid/appid/xms_* - Agent ID編:Agent Identity / Blueprint / FIC / Service Principal
- Security編:Prompt Injection × Graph権限 × Least Privilege
- Governance編:Owner / Sponsor / Access Package / Lifecycle
- Inventory編:Agent Identity × Microsoft Graph × 権限棚卸し(本記事)
- Monitoring編:権限変更の継続的な検出
参考資料
- Microsoft Graph - agentIdentity オブジェクトの一覧表示
- Microsoft Graph - agentIdentity の所有者の一覧表示
- Microsoft Graph - agentIdentity のスポンサーの一覧表示
- Microsoft Graph - servicePrincipal の appRoleAssignments の一覧表示
- Microsoft Graph - スロットリングのガイダンス
- Microsoft Entra Agent ID - 継承可能なアクセス許可
- Microsoft Entra Agent ID - 承認
タグ候補:EntraID MicrosoftGraph PowerShell AIエージェント Security