Join our Newsletter — 33% off our NHI Course

CI/CD workload identity

CI/CD workload identity is the identity posture of a build or deployment runner, including its secrets, tokens, permissions, and trust boundaries. Treating it as an identity surface makes it easier to apply least privilege, revocation, and separation of duties to automation.

Expanded Definition

CI/CD workload identity describes how a build agent, runner, or deployment job is identified and authorised when it interacts with code repositories, artifact stores, cloud APIs, and release systems. The concept goes beyond a single secret or service account. It includes the tokens issued to the workflow, the credentials cached on the runner, the permissions granted by the orchestration platform, and the trust boundary between the pipeline and the systems it can change.

In practice, this is an identity and access problem, not just a DevOps configuration detail. Treating the pipeline as a workload identity helps teams apply least privilege, short-lived credentials, revocation, and separation of duties to automation. This aligns well with the SPIFFE workload identity specification, which frames workloads as first-class identities rather than unnamed compute instances.

Definitions vary across vendors when CI/CD identity is mixed with secrets management, service accounts, or runner hardening. The clearest usage is when the pipeline itself is the subject being authenticated and authorised. The most common misapplication is treating a long-lived secret stored in the pipeline as the identity, which occurs when teams assume credential storage is equivalent to workload authentication.

Examples and Use Cases

Implementing CI/CD workload identity rigorously often introduces orchestration and governance overhead, requiring organisations to weigh automation speed against tighter credential controls and more frequent token issuance.

  • A Git-based deployment pipeline uses short-lived OIDC tokens to assume a cloud role for infrastructure changes instead of storing a static cloud access key.
  • A self-hosted runner receives a narrowly scoped identity that can pull artifacts and sign releases, but cannot read production databases or modify unrelated services.
  • A release job rotates its credentials per run and revokes them after completion, reducing the blast radius if the job environment is compromised.
  • A software supply chain team maps each pipeline stage to a distinct identity so build, test, and deploy actions can be audited separately.
  • A platform team aligns runner authentication with guidance from the CISA software supply chain security program to limit repository and artifact abuse.

These patterns are increasingly common where pipelines sign artifacts, publish containers, or trigger downstream automation. The exact implementation depends on the tooling, but the security goal is consistent: each automated action should present a verifiable identity with only the permissions needed for that step.

Why It Matters for Security Teams

When CI/CD workload identity is poorly governed, an attacker who compromises a runner, workflow token, or build secret can often pivot into source code, cloud infrastructure, or release channels. That turns a single pipeline weakness into a supply chain event. Security teams care because the pipeline often has broader authority than any human user, yet it may be monitored less carefully than interactive access.

This term sits at the intersection of identity security and software delivery. Controls such as short-lived credentials, strong trust boundaries, and explicit authorisation for each job support the same direction taken by modern identity guidance and platform security models. The NIST identity and access management resources are useful for thinking about assurance, while OWASP CI/CD security risks helps frame the attack surface in delivery pipelines.

Organisations typically encounter the operational impact only after a pipeline compromise, at which point CI/CD workload identity becomes unavoidable to contain token abuse, trace actions, and restore trust in the release process.

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 address the attack and risk surface, while NIST SP 800-63, NIST CSF 2.0, NIST Zero Trust (SP 800-207) and NIST AI RMF set the governance and control requirements practitioners need to meet.

Framework Control / Reference Relevance
OWASP Non-Human Identity Top 10 Workload identities and their secrets are central to NHI governance.
NIST SP 800-63 AAL2 Credential assurance concepts help bound how pipeline identities are issued and trusted.
NIST CSF 2.0 PR.AC-4 Least-privilege access applies directly to automated pipeline identities.
NIST Zero Trust (SP 800-207) SC-23 Zero trust principles support per-request verification for automation trust boundaries.
NIST AI RMF AI systems that deploy code inherit the same workload identity and governance risks.

Apply governance, mapping, and monitoring to any AI-driven deployment pipeline with execution authority.