1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

AI Agentの権限は見えているか? Microsoft GraphでAgent Identityを棚卸ししてみた

1
Posted at

この記事は「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にはその情報は現れません。

検証では以下を比較します。

  1. Agent Identityの直接割り当て
  2. Blueprint側で設定・承認された権限と継承設定
  3. 対象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から棚卸ししました。

  1. Agent Identityの一覧だけでは全社のAI Agentを網羅できない:通常のService PrincipalやManaged Identityを使うAgentは別途確認が必要です。
  2. 直接付与された権限だけでは実効権限を断定できない:実際、第2回でBlueprintから継承させたDelegated Permissionは、appRoleAssignmentsには現れませんでした。
  3. Sponsorの取得は権限要件が特殊:ドキュメント上、委任はサポート対象外で、アプリケーション権限もAgentIdentity.ReadWrite.Allしかありません。実測ではAgentIdentity.Read.Allの委任トークンで取得でき、スコープなしでは管理者でも403でした。ただし記載と一致しない経路なので、依存した実装は避けるべきです。
  4. 「情報がない」と「取得できなかった」を区別する:OwnerCount = 0とOwnerStatus = Errorはまったく意味が違います。
  5. Ownerは任意なので、空のまま運用に入りやすい:今回の検証でも、Graph APIから作成したAgentはOwnerが0件でした。棚卸しで最初に見つけたいのはここです。

AI AgentのZero Trust運用では、認証方式の選定に加えて、誰が管理し、どの権限を使えるのかを継続的に説明できることが求められます。
今回のAgent Inventoryは、そのための出発点です。


次回予告

【第7回】Agent Identityの権限変更を検出する ― Microsoft Graphで継続的なPermission Monitoringを考える

次回は今回のInventoryを基に、前回との差分から権限追加・Owner変更・新規Agentを検出し、管理者レビューにつなげる方法を検討します。
あわせて、今回未実装だったBlueprintの継承権限の列挙にも取り組む予定です。

連載の予定

  1. 概念編:Delegated / Application / OBO
  2. Token実測編:scp / roles / oid / appid / xms_*
  3. Agent ID編:Agent Identity / Blueprint / FIC / Service Principal
  4. Security編:Prompt Injection × Graph権限 × Least Privilege
  5. Governance編:Owner / Sponsor / Access Package / Lifecycle
  6. Inventory編:Agent Identity × Microsoft Graph × 権限棚卸し(本記事)
  7. Monitoring編:権限変更の継続的な検出

参考資料


タグ候補:EntraID MicrosoftGraph PowerShell AIエージェント Security

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?