Issuer-controlled claims are token attributes created and signed by a trusted identity system rather than edited by the user. They are used when applications need reliable identity context for authorisation, because writable metadata cannot safely serve as the basis for access decisions.
Expanded Definition
issuer-controlled claims are the trusted, signed attributes that an identity provider, token service, or federation authority places into a token at issuance time. They differ from user-editable profile fields, application-side metadata, and ad hoc claims that can be changed without authoritative verification. In NHI security, these claims are the mechanism that lets a service prove identity context such as tenant, environment, privilege boundary, or workload class before access is granted.
The key distinction is provenance: the claim matters because the issuer vouches for it, not because the application or user has written it. That is why issuer-controlled claims are foundational to NIST Cybersecurity Framework 2.0 style access governance, and why NHIMG treats them as a control-plane concept rather than a data-labeling feature. In practice, definitions vary across vendors on which attributes should be issuer-controlled versus policy-derived, so teams should treat the issuer as the source of truth only for claims it can actually validate and maintain. The most common misapplication is using mutable directory fields or application-managed tags as if they were authoritative claims, which occurs when access logic is built on convenience instead of signed identity evidence.
Examples and Use Cases
Implementing issuer-controlled claims rigorously often introduces federation and token-design constraints, requiring organisations to weigh stronger authorisation integrity against less flexibility in downstream application logic.
- A workload token includes an issuer-signed environment claim that distinguishes production from staging, preventing a service from being reused across boundaries.
- An enterprise IdP asserts tenant and domain claims in a federated session so an application can authorise access without trusting user-entered profile data.
- A service account token carries issuer-controlled claims for workload class and trust zone, allowing policy to block privileged actions outside an approved runtime.
- During NHI review, engineers compare token claims against the guidance in the Ultimate Guide to NHIs — Standards to ensure the issuer, not the app, defines authoritative attributes.
- After a compromise, responders inspect whether the token contained stable issuer claims or merely application-added metadata, then trace whether those claims were accepted by relying services.
These patterns also map cleanly to trust frameworks that separate authentication evidence from downstream policy decisions, including NIST Cybersecurity Framework 2.0 and identity federation guidance that treats signed token content as a security boundary.
Why It Matters in NHI Security
Issuer-controlled claims are what make token-based authorisation reliable when agents, services, and automated pipelines interact at machine speed. Without them, applications tend to fall back on mutable attributes, manual overrides, or local database flags, which creates a gap between the identity that was authenticated and the identity context that was actually trusted for access. That gap becomes dangerous in NHI estates because the same token may be reused by many services, and a single bad claim can propagate privilege far beyond the original issuer boundary.
This is one reason NHIMG research on the DeepSeek breach and broader secret exposure patterns shows how quickly machine identities can be abused once trust signals are weak or poorly governed. In the linked NHIMG analysis of LLMjacking, attackers attempted access to exposed AWS credentials within 17 minutes on average, showing how little time exists to rely on compensating controls once issuance trust is broken. Issuer-controlled claims reduce that blast radius by making authorisation decisions depend on signed, authoritative context rather than writable fields or convenience labels. Organisations typically encounter the operational urgency of issuer-controlled claims only after a token is replayed, an entitlement is abused, or a workload crosses a boundary it was never meant to reach, at which point the concept becomes operationally unavoidable to address.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
OWASP Non-Human Identity Top 10 and OWASP Agentic AI Top 10 address the attack and risk surface, while NIST CSF 2.0, NIST SP 800-63 and NIST Zero Trust (SP 800-207) set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| OWASP Non-Human Identity Top 10 | NHI-01 | Authoritative token claims support secure NHI authorization and reduce reliance on mutable metadata. |
| NIST CSF 2.0 | PR.AC-1 | Federated identity and access controls depend on trusted identity assertions. |
| NIST SP 800-63 | Digital identity guidance emphasizes trusted assertion provenance and verifier reliance. | |
| NIST Zero Trust (SP 800-207) | Zero Trust requires continuous trust evaluation based on authoritative identity context. | |
| OWASP Agentic AI Top 10 | A2 | Agentic systems need trustworthy identity context before tool use or execution. |
Ensure downstream access decisions use issuer-signed claims, not user-editable fields or local app flags.