Join our Newsletter — 33% off our NHI Course
Home› Glossary› Cyber Security› Commit SHA
Cyber Security

Commit SHA

← Back to Glossary
By NHI Mgmt Group Updated October 30, 2026 Domain: Cyber Security

A commit SHA is the unique identifier for a single revision in a Git repository. When used in a GitHub Actions workflow, it points to an exact code state that cannot be changed after the fact, which makes it the strongest form of action pinning for security and repeatability.

What a commit SHA actually gives you

A commit SHA ties a workflow, deployment, or review step to one exact repository state. That matters because the reference is immutable: if the commit changes, the SHA changes too. In practice, this makes it a stronger pin than branch names or tags when you need repeatable builds and security-sensitive automation.

For security teams, the value is not just determinism. It is also traceability. A commit SHA gives you a stable anchor for proving which source revision was executed, which is important when you need to reason about provenance, compare environments, or investigate whether a workflow used the code you expected.

Why commit SHA pinning is stronger than moving references

Branch names and lightweight tags are convenient, but they can move. That flexibility is useful for development, yet it creates ambiguity in automation because “latest” can become a different artifact tomorrow. A commit SHA removes that ambiguity by binding execution to one revision that cannot be silently retargeted.

This is why commit sha pinning is often treated as the strongest form of action pinning in GitHub Actions. It limits the chance that a trusted action reference, dependency pointer, or workflow step is changed upstream after review. The security benefit is strongest when the workflow itself is intended to be repeatable across time, environments, and operators.

For broader CI/CD hardening, see CI/CD Pipeline Identity Security Guide and GitHub and GitHub Actions Security Guide.

Where commit SHA fits in the supply chain

A commit SHA is only one control in a larger software supply chain story. It helps you prove which source snapshot was intended, but it does not by itself prove that the code is safe, that dependencies are benign, or that the build pipeline was not compromised. It should be paired with provenance, signing, review discipline, and controls over who can alter workflow definitions or repository content.

That distinction matters because an attacker who can influence source content before the SHA is chosen can still shape what gets built. Pinning reduces the risk of post-review drift, but it does not remove risk from malicious commits, compromised maintainers, poisoned dependencies, or altered runner behavior. In other words, the SHA protects immutability of reference, not the trustworthiness of the code already at that reference.

For the governance side of third-party actions and integrations, consult OWASP CI/CD Top 10 CICD-SEC-8 Ungoverned Usage of Third-Party Services Guide.

How practitioners should use commit SHA pinning

The practical rule is simple: use commit SHA pinning when you need exact reproducibility, especially for production workflows, reusable actions, and release automation. It is most valuable where the security question is “did we run the exact code we reviewed?” rather than “did we get a convenient stable label?”

Teams should also treat SHA pinning as part of change control. If a workflow depends on a specific revision, then updates to that revision should be deliberate, reviewed, and documented like any other security-relevant software change. That keeps the pin useful as an assurance mechanism instead of merely becoming a hardcoded reference that nobody revisits.

Practitioner takeaway: use commit SHA pinning wherever repeatability and provenance matter, but do not mistake an immutable reference for a guarantee that the referenced code is trustworthy.

Standards & Framework Alignment

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

SLSA, CIS Controls v8 and OWASP SAMM set the governance and control requirements practitioners need to meet.

FrameworkControl / ReferenceRelevance
SLSABuild ProvenanceCommit SHAs anchor builds to exact source revisions for provenance and repeatability.
Recommendation — Pin builds to immutable source revisions and verify artifact provenance before release.
CIS Controls v8CIS-16 — Application Software SecurityCommit SHA pinning supports controlled software change and trusted build inputs.
Recommendation — Require approved, immutable references for release workflows and software dependencies.
OWASP SAMMVerificationRepeatable workflow references strengthen software assurance and review discipline.
Recommendation — Make exact version pinning part of your software verification and release practices.

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 30, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org