# Agent Identities should have an active Agent Identity Blueprint Principal (Preview)

Agent Identities should have an existing Agent Identity Blueprint Principal.

Source: https://maester.dev/docs/tests/MT.1200

<!-- This file is generated by website/scripts/generate-test-docs.mjs. Do not edit manually. -->

<div class="test-byline"><div class="test-byline-avatars"><a class="test-byline-avatar test-byline-avatar--author" href="/contributors/agnivesh" title="Agnivesh S. · Original author"><img src="https://github.com/agnivesh.png" alt="Agnivesh S." width="28" height="28" loading="lazy" decoding="async" /></a></div><div class="test-byline-meta"><span class="test-byline-text">Contributed by <a href="/contributors/agnivesh">Agnivesh S.</a></span><a class="test-byline-link" href="/contributors">All contributors →</a></div></div>

<p class="test-part">Part of <a href="/docs/tests/maester">Maester</a> · Entra ID · Agent identities · <a href="/docs/tests">All checks</a></p>

```powershell title="Run this check"
Invoke-Maester -TestId MT.1200 -IncludePreview
```

## Overview

Agent Identities should have an existing Agent Identity Blueprint Principal.

An Agent Identity is the account an AI agent uses to access resources in your tenant. It is
created from an Agent Identity Blueprint. The Blueprint Principal is the tenant's copy of that
blueprint and provides the parent relationship used to manage the agent's ownership, permissions,
and lifecycle.

This check looks for Agent Identities whose parent Blueprint Principal is missing. Without that
parent, the identity may no longer be able to authenticate or be managed through its blueprint.
It can also leave stale directory data and access assignments in the tenant. Treat a finding as
something to investigate. Confirm why the identity exists and whether it is still needed before
deleting it.

### Remediation action:

1. Open the [Microsoft Entra admin center][entra-admin-center] and go to **Entra ID** >
   **Agents** > **Agent identities**. Search for the reported identity by its **Object ID** or
   name.
2. Review its status, owners and sponsors, permissions, audit logs, and sign-in logs. If the
   report includes a **Blueprint App ID**, use it to find the parent blueprint.
3. Go to **Entra ID** > **Agents** > **Agent blueprints** and search by **Blueprint App ID**.
   If the blueprint is present, review its status and linked agent identities. If it is missing,
   find out whether it was deleted or removed from the tenant.
4. If the agent is still needed, follow Microsoft's [restore guidance][agent-id-restore].
   The admin center cannot restore a blueprint or Blueprint Principal.
5. If the agent is no longer needed, disable it first, review its access, and then follow
   Microsoft's [delete guidance][agent-id-delete]. Deleting a blueprint or Blueprint Principal
   can also clean up its child identities and Agent Users.

### Related links

* [View and filter agent identities][agent-identity-list]
* [View and manage agent identity blueprints][blueprint-principal-list]
* [Disable agent identities][agent-id-disable]
* [How to delete and restore agent identity objects][agent-id-delete]

[entra-admin-center]: https://entra.microsoft.com
[agent-identity-list]:
  https://learn.microsoft.com/entra/agent-id/agent-lists
[blueprint-principal-list]:
  https://learn.microsoft.com/entra/agent-id/manage-agent-blueprint
[agent-id-disable]: https://learn.microsoft.com/entra/agent-id/disable-agent-identities
[agent-id-restore]:
  https://learn.microsoft.com/entra/agent-id/howto-delete-agent-identity#restore-a-blueprint-principal
[agent-id-delete]: https://learn.microsoft.com/entra/agent-id/howto-delete-agent-identity

## Details

<details>
<summary>Every attribute of this check</summary>

| Field | Value |
| --- | --- |
| Test ID | MT.1200 |
| Severity | Medium |
| Suite | Maester |
| Product | Entra ID |
| Feature | Agent identities |
| Area | AI and agents |
| Resource type | Agent |
| User impact | Low |
| Implementation cost | Low |
| MITRE ATT&CK | T1078.004 Cloud Accounts |
| PowerShell test | [Test-MtEntraAgentIdentityOrphaned](https://github.com/maester365/maester/blob/main/tests/maester/entra/Test.MT.1200.ps1) |
| Services | Graph |
| Lifecycle | Preview |

</details>

## Source

- Test: [`tests/maester/entra/Test.MT.1200.ps1`](https://github.com/maester365/maester/blob/main/tests/maester/entra/Test.MT.1200.ps1)
- Documentation: [`tests/maester/entra/Test.MT.1200.md`](https://github.com/maester365/maester/blob/main/tests/maester/entra/Test.MT.1200.md)
