Skip to content
3.0 preview2.3.0 stable

These docs describe the preview. Pick the version you run and every page marks what it doesn't have yet. Get the preview →
Maester 2.x docs (archived) →

Sponsor

Agent Users should have an existing parent Agent Identity (Preview)

MT.1201MediumEntra IDAgent identitiesRuns with -IncludePreview

Part of Maester · Entra ID · Agent identities · All checks

Run this check
Invoke-Maester -TestId MT.1201 -IncludePreview

Agent Users should have an existing Agent Identity.

An Agent User is the Entra user account paired with an Agent Identity. Some agents need this second account to access systems that require a user account. The two accounts should share the same lifecycle.

This check looks for Agent Users whose parent Agent Identity is missing. The account can be left behind after the agent is deleted and may still have group memberships, licenses, or other access. That makes it harder to tell why the account exists and whether it should still have access.

  1. Open the Microsoft Entra admin center and go to Entra ID > Users. Search for the Agent User by its Object ID or user principal name. The report’s parent value is an object ID; identityParentId is not a portal field.
  2. Go to Entra ID > Agents > Agent identities and search for the parent Agent Identity object ID. Review its status, owners and sponsors, permissions, audit logs, and sign-in logs if it still exists.
  3. If the Agent Identity is still needed, follow Microsoft’s restore guidance. If its blueprint or Blueprint Principal was deleted, restore that parent first when possible.
  4. If the Agent User is no longer needed, review its group memberships, licenses, and access. Then delete it from Entra ID > Users or follow Microsoft’s Agent ID deletion guidance. Deletion is soft by default, so the user can normally be restored for 30 days.
Every attribute of this check
FieldValue
Test IDMT.1201
SeverityMedium
SuiteMaester
ProductEntra ID
FeatureAgent identities
AreaAI and agents
Resource typeAgent
User impactLow
Implementation costLow
MITRE ATT&CKT1078.004 Cloud Accounts
PowerShell testTest-MtEntraAgentUserOrphaned
ServicesGraph
LifecyclePreview