An in-toto statement is a signed metadata record that describes a step in a software supply chain, such as building, testing or packaging. It links materials, products, commands and the responsible function so later checks can verify that the step really happened as declared and that the artefact chain is intact.
What the Statement Represents in a Supply Chain
An in-toto statement is not just a log line or checksum, it is a signed description of one declared supply-chain step. It records what was used, what was produced, and which function performed the work, so the step can later be checked against policy and provenance expectations.
That makes the statement a metadata boundary, not an artefact itself. Its value comes from linking the action to evidence that can be verified after the fact, which is why it is used with signed attestations and provenance systems rather than as a standalone integrity control.
How It Fits into Build Provenance and Attestation
In-toto statements sit inside a larger provenance model: they describe materials, products, commands and responsibility, then give verifiers a structured record to compare against what should have happened. In practice, they help connect a build step to the resulting artefact chain without relying on trust in the build host alone.
The in-toto Attestations Guide is the clearest place to understand the statement and predicate layers together, including how verification policy uses them to reject bad builds.
Because the statement is signed, it also supports tamper evidence. If an attacker alters the build inputs, substitutes outputs, or tries to hide an unexpected command, the mismatch is meant to show up when the statement is checked against policy or against other provenance records.
Why It Matters for Software Integrity
In-toto statements matter because software supply-chain compromise often hides in the gap between “a build happened” and “the right build happened in the right way.” A statement narrows that gap by making the declared process inspectable and by giving downstream consumers a way to validate the chain of custody for an artefact.
This is especially useful when organisations depend on signed provenance to prove that packaging, testing or release steps were performed under expected conditions. The SLSA and Build Provenance Guide shows how in-toto attestation fits into build provenance, keyless signing and deploy-time checks.
It also aligns with deployment pipelines that reject artefacts unless integrity evidence is present. The OWASP CI/CD Top 10 CICD-SEC-9 Improper Artifact Integrity Validation Guide explains why artifact signing and provenance verification need to happen before each deployment step.
What Verifiers Look For in Practice
Verifiers usually care less about the narrative label on the statement and more about whether the recorded materials, outputs and execution details match the expected workflow. The check is strongest when the statement is paired with policy that defines what a valid step looks like and when downstream systems reject artefacts that do not match that policy.
That means organisations should treat statement verification as part of the release control plane, not as an optional audit artefact. If the statement is present but never checked, or if checks are too permissive to detect unexpected commands, the trust value of the metadata drops sharply.
In broader control terms, this is a provenance and integrity problem as much as a signing problem, which is why the surrounding build and release system must preserve the chain from source to artefact to deployment.
Risk and Threat Considerations
In-toto statements reduce supply-chain blind spots, but they can be weakened when build systems are misconfigured, when the wrong artefacts are signed, or when verifiers accept incomplete provenance. Attackers benefit from those gaps because a forged or absent statement can make an altered build look legitimate longer than it should.
Failure mechanism: The chain breaks when the recorded step does not accurately represent the real build action, when the signing process is compromised, or when policy fails to reject missing or inconsistent provenance.
Impact: Downstream consumers may trust a tampered artefact, accept an unauthorised build path, or lose the ability to prove that a released package came from the expected source and process.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
SLSA, OWASP SAMM, CIS Controls v8 and NIST SP 800-53 Rev 5 set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| SLSA | Supply-chain Levels for Software Artifacts | In-toto statements underpin build provenance and artefact integrity verification. |
| Recommendation — Require signed provenance for builds and reject artefacts that lack verifiable supply-chain evidence. | ||
| OWASP SAMM | Software Assurance Maturity Model | It governs integrating security into software delivery and provenance practices. |
| Recommendation — Embed provenance checks into software delivery practices and measure whether release controls actually verify them. | ||
| CIS Controls v8 | CIS-16 — Application Software Security | Release integrity and provenance checks support secure software handling and deployment assurance. |
| Recommendation — Validate software provenance before promotion and deployment. | ||
| NIST SP 800-53 Rev 5 | SI-7 — Software, Firmware, and Information Integrity | Signed statements support integrity verification of software artefacts and release chains. |
| AU-10 — Non-repudiation | Signed statements create evidence that a declared build step occurred and can be attributed. | |
| Recommendation — Verify software artefacts and provenance before deployment and block releases that fail integrity checks. Preserve signed build evidence so declared supply-chain actions remain attributable and reviewable. | ||
Practitioner Guidance
Why practitioners should care: Treat in-toto statements as enforcement evidence, not documentation. Their real value appears only when release policy, signing, and verification are wired together so that unexpected build behaviour can be blocked before deployment.
What to watch for: Look for pipelines that generate attestations but do not verify them, or that verify only part of the chain. Those are common failure patterns because they preserve the appearance of provenance while leaving artefact integrity assumptions untested.
Practitioner takeaway: A statement is most useful when every step that matters can be independently checked later, and every artefact that matters is refused if that check fails.
Related resources from NHI Mgmt Group
Deepen Your Knowledge
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.
Reviewed and updated by the NHIMG editorial team on October 29, 2026.
NHI Mgmt Group — the #1 independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org