A custom OIDC workflow is a trust pattern for any platform or workload that can issue its own OIDC token, not just a single CI/CD system. It extends identity-based credential delivery to services, Kubernetes accounts, cloud workloads, and AI agents, provided the issuer, claims, and trust boundaries are explicitly defined.
Expanded Definition
Custom OIDC Workflow describes an identity pattern where a platform, workload, or agent issues its own OpenID Connect token and uses explicit trust rules to exchange that token for downstream access. It is broader than a single CI/CD integration because the issuer, claims, audience, and validation logic are designed around the workload itself, not around a vendor default.
In Non-Human Identity operations, this pattern is used to replace long-lived secrets with short-lived, attestable credentials for services, Kubernetes service accounts, cloud workloads, and AI agents. The trust model must be defined with the same discipline expected in NIST Cybersecurity Framework 2.0: identity, authentication, authorization, and monitoring all need clear ownership. Industry usage is still evolving, so “custom” usually means the organisation controls the issuer or token exchange path rather than relying only on a hosted provider template.
The most common misapplication is treating any JWT-based workflow as OIDC, which occurs when teams skip issuer validation, audience restrictions, or token lifetime controls.
Examples and Use Cases
Implementing custom OIDC rigorously often introduces more policy design and validation overhead, requiring organisations to weigh secret elimination and portability against the cost of maintaining token trust boundaries.
- A Kubernetes workload uses a projected service account token to request cloud access, with claims mapped to a narrowly scoped role.
- An AI agent exchanges an internally issued OIDC token for a temporary API credential after passing policy checks on tool scope and environment.
- A platform team builds a federation layer for multiple services so each workload can authenticate without embedding static API keys in code or configuration.
- A CI pipeline mints a short-lived token tied to repository, branch, and runner identity, reducing exposure during build execution.
This pattern is often discussed alongside breach lessons such as the OneLogin API Key Vulnerability and the GitHub Action tj-actions Supply Chain Attack, where token handling and trust boundaries were central to exposure. For protocol semantics, OIDC specifications and federation guidance remain the baseline reference point, even when the implementation is custom.
Why It Matters in NHI Security
Custom OIDC Workflow matters because it is one of the cleanest ways to issue ephemeral, identity-bound access to non-human actors without relying on hardcoded secrets. When designed well, it supports least privilege, stronger rotation posture, and clearer revocation paths. When designed poorly, it creates a false sense of security because the token looks modern while the trust chain is still weak.
NHIMG research shows that only 5.7% of organisations have full visibility into their service accounts, and 97% of NHIs carry excessive privileges. Those figures make custom OIDC especially important for governance, because the workflow can either reduce standing access or simply hide it behind a new issuer. The NIST Cybersecurity Framework 2.0 remains useful for mapping ownership, continuous monitoring, and response expectations around these workflows.
Organisations typically encounter token abuse, privilege escalation, or broken service-to-service access only after a secret leak, an expired claim, or an issuer compromise, at which point Custom OIDC Workflow 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 Zero Trust (SP 800-207) and NIST SP 800-63 set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| OWASP Non-Human Identity Top 10 | NHI-01 | Custom token issuers expand NHI attack surface and trust boundaries. |
| NIST CSF 2.0 | PR.AC | OIDC workflows are access control mechanisms for non-human identities. |
| NIST Zero Trust (SP 800-207) | SC-7 | Custom OIDC supports zero trust only when every exchange is explicitly verified. |
| NIST SP 800-63 | AAL2 | OIDC assurance depends on token strength, proof, and lifecycle controls. |
| OWASP Agentic AI Top 10 | A3 | Agentic systems using custom OIDC need bounded execution authority and tool access. |
Match workload authentication strength to the access being requested and keep tokens short-lived.
Related resources from NHI Mgmt Group
- How do custom OIDC attributes affect identity lifecycle control?
- What is OpenID Connect (OIDC) and how does it extend OAuth 2.0 for NHIs?
- Why can't OAuth 2.0 and OIDC alone fully solve NHI authentication challenges?
- How should organisations secure workflow platforms that handle both files and secrets?
Deepen Your Knowledge
Reviewed and updated by the NHIMG editorial team on August 24, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org