Skills entra-agent-id
๐Ÿ“ฆ

entra-agent-id

v1.0.1 Content revision r2 High Risk โš™๏ธ External commands๐Ÿ“ Filesystem access๐ŸŒ Network access๐Ÿ”‘ Env variables

Provision Microsoft Entra Agent Identities

Agent identity provisioning and OAuth token exchange require coordinated Microsoft Graph configuration. This skill provides workflows for Blueprints, per-instance identities, permissions, and sidecar deployment.

Supports: Claude Codex Code(CC)
โš ๏ธ 38 Poor

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request
Review the Skillstore skill "entra-agent-id" from https://skillstore.io/skills/microsoft-entra-agent-id.md and its manifest at https://skillstore.io/api/skills/microsoft-entra-agent-id/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Test it

Using "entra-agent-id". Plan three identities for a customer-support agent with read-only user access.

Expected outcome:

  • Prerequisites: required Entra role, Graph permissions, sponsor user, and tenant identifiers.
  • Sequence: create Blueprint, create BlueprintPrincipal, create three named Agent Identities, then verify each object.
  • Permission plan: grant only the approved read-only role to each identity and record object identifiers.

Using "entra-agent-id". Explain why my autonomous token exchange returns AADSTS82001.

Expected outcome:

The flow used the RFC 8693 token-exchange grant. Use client credentials with fmi_path, then request the Graph default scope in step two.

Using "entra-agent-id". Review a Kubernetes AgentID sidecar deployment.

Expected outcome:

  • Keep the sidecar bound to loopback and avoid LoadBalancer or Ingress exposure.
  • Use workload identity with a signed assertion file instead of a client secret.
  • Separate non-secret configuration from credentials and apply resource limits and health probes.

Security Audit

High Risk
v5 โ€ข 7/24/2026 Open versioned report

Most static alerts are false positives caused by Markdown syntax, OAuth scope strings, official Microsoft endpoints, and bounded configuration examples. One example can forward an agent bearer token to an unrestricted URL, while semantic review found an exposed sidecar port and broad long-lived delegated grants.

7
Files scanned
1,153
Lines analyzed
1
Review items
0
False positives ignored

Confirmed security concerns (2)

High
Authentication Sidecar Published on Host Network
The Docker Compose example publishes sidecar port 5000 as host port 5001. Docker binds published ports broadly by default, exposing unauthenticated token endpoints beyond the private network.
The manifest publishes the sidecar port, while the endpoint reference confirms unauthenticated token acquisition routes. The security section requires local-only access.
Medium
Broad, Long-Lived Delegated Permission Grants
Examples create AllPrincipals delegated grants for broad Graph scopes with a ten-year expiry. Copied defaults can provide excessive access across the tenant.
Both examples explicitly combine AllPrincipals consent with broad scopes and a 3650-day expiry. No shorter production default is shown.
Capability review items (1)

These are real local capabilities that may be expected for this skill, so they require review but are not counted as confirmed malicious behavior.

High
Python HTTP libraries
resp = requests.get(endpoint, headers={"Authorization": token}, timeout=10)
The example sends an agent bearer token to an unrestricted endpoint parameter. Untrusted input could redirect the token to an attacker-controlled host.

Risk Factors

โš™๏ธ External commands (50)
๐Ÿ“ Filesystem access (15)
๐ŸŒ Network access (50)
references/oauth2-token-flow.md:21 references/oauth2-token-flow.md:39 references/oauth2-token-flow.md:111 references/oauth2-token-flow.md:35 references/oauth2-token-flow.md:63 references/oauth2-token-flow.md:72 references/oauth2-token-flow.md:101 references/obo-blueprint-setup.md:41 references/obo-blueprint-setup.md:63 references/obo-blueprint-setup.md:84 references/runtime-token-exchange.md:17 references/runtime-token-exchange.md:36 references/runtime-token-exchange.md:40 references/runtime-token-exchange.md:91 references/runtime-token-exchange.md:95 references/runtime-token-exchange.md:120 references/runtime-token-exchange.md:124 references/runtime-token-exchange.md:9 references/runtime-token-exchange.md:19 references/runtime-token-exchange.md:88 references/runtime-token-exchange.md:117 references/sdk-sidecar-deployment.md:56 references/sdk-sidecar-deployment.md:18 references/sdk-sidecar-deployment.md:24 references/sdk-sidecar-deployment.md:34 references/sdk-sidecar-deployment.md:72 references/sdk-sidecar-deployment.md:85 references/sdk-sidecar-deployment.md:13 references/sdk-sidecar-deployment.md:46 references/sdk-sidecar-deployment.md:107 references/sdk-sidecar-deployment.md:112 references/sdk-sidecar-deployment.md:113 references/sdk-sidecar-deployment.md:115 references/sdk-sidecar-deployment.md:122 references/sdk-sidecar-deployment.md:149 references/sdk-sidecar-deployment.md:168 references/sdk-sidecar-deployment.md:168 references/sdk-sidecar.md:50 references/sdk-sidecar.md:83 references/sdk-sidecar.md:85 SKILL.md:147 SKILL.md:165 SKILL.md:186 SKILL.md:224 SKILL.md:231 SKILL.md:249 SKILL.md:19 SKILL.md:116 SKILL.md:118 SKILL.md:144
๐Ÿ”‘ Env variables (12)
Audited by: codex View Audit History โ†’
Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report
Security Assessment

Copy report link

https://skillstore.io/skills/microsoft-entra-agent-id/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/microsoft-entra-agent-id/security.svg)](https://skillstore.io/skills/microsoft-entra-agent-id?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/microsoft-entra-agent-id?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/microsoft-entra-agent-id/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/microsoft-entra-agent-id.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Academic citations (APA ยท BibTeX ยท CFF)

APA citation

microsoft. (2026). entra-agent-id security audit report (audit version 5) [Author version 1.0.1]. Skillstore. https://skillstore.io/skills/microsoft-entra-agent-id/audits/5

BibTeX citation

@techreport{microsoft-microsoft-entra-agent-id-2026, author = {microsoft}, title = {entra-agent-id security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/microsoft-entra-agent-id/audits/5}, note = {Author version 1.0.1} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "entra-agent-id security audit report (audit version 5)" version: "1.0.1" type: report authors: - name: "microsoft" date-released: "2026-07-24" url: "https://skillstore.io/skills/microsoft-entra-agent-id/audits/5" identifiers: - type: other value: "skillstore:microsoft-entra-agent-id:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: Medium
45
Architecture
100
Maintainability
87
Content
68
Community
91
Spec Compliance

What You Can Build

Provision an agent identity hierarchy

Create a Blueprint, its principal, and separately auditable identities for each deployed agent instance.

Implement runtime token exchange

Configure autonomous or on-behalf-of authentication with per-agent Microsoft Graph permissions.

Deploy a polyglot authentication sidecar

Prepare local Docker or Kubernetes sidecar configuration for agents written in any supported language.

Try These Prompts

Check prerequisites
List the Entra roles, Graph permissions, tools, and tenant details required to create an Agent Identity Blueprint. Do not make changes.
Plan identity provisioning
Create a step-by-step plan for a Blueprint named {name} with {count} Agent Identities. Include sponsors, permissions, validation, and rollback.
Design an OBO flow
Design an on-behalf-of flow for {agent} using {scopes}. Explain Blueprint API configuration, per-agent grants, token audiences, and validation.
Review a production deployment
Review my AgentID sidecar and cross-tenant token design. Identify excessive permissions, exposed endpoints, credential risks, tenant mistakes, and concrete remediations.

Best Practices

  • Verify current Microsoft documentation before applying Graph request bodies or SDK configuration.
  • Use workload identity federation in production and keep sidecar endpoints private.
  • Grant the minimum permissions to each Agent Identity and confirm propagation before testing.

Avoid

  • Do not attach credentials directly to Agent Identity service principals.
  • Do not expose AgentID sidecar token endpoints through public ports, ingress, or load balancers.
  • Do not grant broad Microsoft Graph scopes when a smaller per-agent permission set works.

Frequently Asked Questions

What objects does this skill create?
It covers an Agent Identity Blueprint, its BlueprintPrincipal, and separate Agent Identity service principals for individual instances.
Can I use DefaultAzureCredential?
No. The documented Agent Identity APIs reject Azure CLI tokens carrying Directory.AccessAsUser.All. Use dedicated application or delegated credentials.
Where should credentials be stored?
Store credentials on the Blueprint. Use workload identity federation or managed identity for production and client secrets only for development.
Does the skill support on-behalf-of authentication?
Yes. It explains Blueprint API configuration, user token audiences, delegated grants, and the two-step OBO exchange.
Can the sidecar be publicly exposed?
No. Keep it on loopback or a private container network because some token acquisition endpoints do not require inbound authentication.
Does this replace standard Entra app registration guidance?
No. It is specific to Microsoft Entra Agent ID objects and related token flows.

Developer Details

Author

microsoft

License

MIT

Author version

v1.0.1

Skillstore revision

r2

Ref

9e952417e76879bc9d853e1b8b2cd6d6d8d4a1c2

Maintenance freshness

7/24/2026

Usage

2 downloads ยท 87 views

File structure

More from microsoft

View all
View all