Join our Newsletter — 33% off our NHI Course
Home› Glossary› Foundations & NHI Taxonomy› Instance Metadata Service Version 2 (IMDSv2)
Foundations & NHI Taxonomy

Instance Metadata Service Version 2 (IMDSv2)

← Back to Glossary
By NHI Mgmt Group Updated October 28, 2026 Domain: Foundations & NHI Taxonomy

Instance Metadata Service Version 2 is a cloud metadata access method that lets a workload fetch instance details and temporary credentials from a local metadata endpoint. It uses session-oriented requests with a token, which reduces exposure to server-side request forgery attacks that try to reach instance credentials.

How IMDSv2 changes metadata access

instance metadata service Version 2 replaces simple metadata fetches with a session-oriented token exchange. That shift matters because the caller must first obtain a token, then present it on subsequent requests, which narrows the easiest path for metadata abuse.

The practical difference is not that metadata disappears, but that access becomes more deliberate. For a workload, this keeps instance details and temporary credentials behind a short-lived session boundary rather than exposing them to any component that can make a plain HTTP request to the local endpoint.

Why IMDSv2 exists in cloud workloads

IMDSv2 is primarily a defensive response to server-side request forgery against cloud metadata endpoints. When an application, proxy, or adjacent service can be induced to make outbound requests, attackers often try to steer that request toward local metadata service to retrieve role credentials or instance facts.

That risk is especially important in cloud environments where metadata access can translate into real privilege. The issue is not just disclosure of machine details, but exposure of temporary credentials that may open access to storage, messaging, secrets, or other services attached to the instance role.

For readers comparing metadata patterns across platforms, NHIMG’s Cloud Instance Metadata Services Compared Guide is useful context because it shows how AWS, Azure, Google Cloud and OCI differ in headers, legacy endpoints and credential delivery.

How organisations verify exposure and harden the path

Exposure checks usually start with inventory and path analysis: which workloads can reach the metadata endpoint, which applications make outbound HTTP calls, and whether containers, proxies or build agents can be tricked into forwarding requests. The key question is not only “is IMDSv2 available?” but “what can still reach metadata in practice?”

Hardening then focuses on reducing fallback paths. Organisations should align instance settings, account defaults and deployment guardrails so that token-based metadata access is enforced consistently, especially where mixed fleets still contain older patterns or where containers share the host network stack.

NHIMG’s EC2 Instance Metadata Service Hardening Guide covers the token model, hop limits for containers and enforcement patterns, while the SSRF Prevention Guide explains URL validation and egress controls that help block metadata abuse before a request ever reaches the endpoint.

What exploitation and post-compromise review look for

When IMDS is abused, the usual failure pattern is credential retrieval followed by lateral movement into cloud services that trust the instance role. Because temporary credentials can be used quickly and quietly, defenders should assume that metadata exposure may lead to actions outside the original host, not just local readout.

Post-incident review should therefore examine logs for unusual metadata access, suspicious outbound requests, and any use of cloud API calls made shortly after a server-side request forgery event or container escape. If exploitation is suspected, rotate or revoke any credentials, sessions or role-delivery paths that may have been exposed.

NHIMG’s MITRE ATT&CK T1552 Unsecured Credentials Guide covers cloud instance metadata API exposure as a credential-access pattern, and the Cloud Forensics Guide is relevant when you need to reconstruct cloud activity after suspected metadata theft.

How IMDSv2 fits into cloud identity and misconfiguration controls

IMDSv2 is best understood as a control on temporary credential delivery, not as a standalone identity system. It works alongside role assignment, least privilege and cloud configuration hygiene, because metadata protection only helps when the attached role is appropriately scoped and the surrounding workload path is not overexposed.

That is why IMDSv2 often appears in the same operational conversation as misconfiguration, workload identity and container hardening. It narrows one abuse path, but it does not compensate for excessive permissions, weak network boundaries or application designs that allow arbitrary outbound fetches.

For broader governance and implementation context, NHIMG’s Cloud Workload Identity Guide and Cloud Misconfiguration Guide help place IMDSv2 in the wider pattern of workload authentication, cloud role design and configuration drift.

Risk and Threat Considerations

IMDSv2 reduces, but does not eliminate, the risk that a vulnerable application or proxy can be turned into a path to instance credentials. The remaining threat is concentrated in environments where SSRF, container breakout, permissive routing or metadata proxying still make the endpoint reachable from untrusted code paths.

Failure mechanism: An attacker induces a server-side request or adjacent workload request to reach the metadata endpoint, then uses the token-based session to obtain temporary credentials and pivot into cloud APIs.

Impact: The result can include unauthorized access to storage, secrets, messaging or control-plane resources, followed by persistence or lateral movement using the exposed role.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

OWASP API Security Top 10 addresses the attack and risk surface, while NIST SP 800-53 Rev 5 and CIS Controls v8 set the governance and control requirements practitioners need to meet.

FrameworkControl / ReferenceRelevance
NIST SP 800-53 Rev 5IA-9 — Service Identification and AuthenticationIMDSv2 protects service-to-service credential access to cloud metadata
AC-6 — Least PrivilegeIMDSv2 is only safe when the attached role is minimally scoped
SC-7 — Boundary ProtectionSSRF and metadata abuse are boundary-reachability problems for local endpoints
Recommendation — Require token-based metadata access for workloads that call cloud identity endpoints. Limit instance role permissions so exposed metadata cannot become broad cloud access. Restrict request paths and egress routes that can reach metadata services.
CIS Controls v8CIS-4 — Secure Configuration of Enterprise Assets and SoftwareIMDSv2 enforcement is a cloud hardening and configuration baseline issue
Recommendation — Enforce metadata hardening settings as part of your secure cloud configuration baseline.
OWASP API Security Top 10API7 — Server Side Request ForgeryThe term exists to reduce SSRF reachability to cloud metadata endpoints
Recommendation — Treat metadata fetch paths as SSRF sinks and block untrusted URL fetches.

Practitioner Guidance

Why practitioners should care: IMDSv2 only delivers its value when it is enforced consistently across fleets, because mixed settings or legacy exceptions create the exact downgrade paths attackers look for. Treat metadata access as part of the workload trust boundary, not as a harmless local convenience.

What to watch for: Investigate any workload that can make arbitrary outbound requests, any container that can reach host metadata, and any environment where role credentials are unexpectedly available without token-based session flow. Those conditions usually matter more than the version label alone.

Practitioner takeaway: Pair IMDSv2 enforcement with role minimization and SSRF controls, otherwise the endpoint remains protected in theory but still reachable through another path.

Free weekly newsletter

Subscribe to the NHI & AI Identity Journal

The latest on NHI and Agentic AI security – articles, research, breaches, news and events every week.

Bonus 33% off our NHI Course when you subscribe.

NHIMG Editorial Note
Reviewed and updated by the NHIMG editorial team on October 28, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org