Skip to main content

Crate attestation_verify

Crate attestation_verify 

Source
Expand description

Verify GitHub Artifact Attestations (Sigstore bundles) offline, at runtime, in Rust, with a minimal and auditable dependency footprint.

See DESIGN.md in the repository root for the full design.

§Status: functional, narrow scope

This crate implements a complete offline verification chain — DSSE signature, Rekor v1 transparency-log inclusion (SET + Merkle proof + checkpoint), X.509/Fulcio chain validation, embedded SCT verification, and GitHub identity-policy matching — for one bundle shape: actions/attest-build-provenance-style bundles carrying a https://slsa.dev/provenance/v1 predicate, verified against the embedded Sigstore public-good trust root or a caller-supplied one. Verifier::verify_digest / Verifier::verify_bytes report success only once every step of that chain has verified; the caller supplies an identity policy and an exact checkpoint-origin policy (DESIGN.md “Core decisions” item 2).

Out of scope for now (typed UnsupportedError, never silently accepted): GitHub’s own TSA-timestamped release-attestation flavor (initiator: github, no tlog entries), Rekor v2 (Ed25519, tiles/sharded logs), and any predicate type other than SLSA provenance v1. This crate has not been independently audited; see README.md for the exact verified scope and DESIGN.md for the full design and roadmap.

§Layout

Re-exports§

pub use bundle::AttestationEntry;
pub use bundle::BUNDLE_MEDIA_TYPE;
pub use bundle::Bundle;
pub use bundle::BundleSet;
pub use bundle::Certificate;
pub use bundle::Checkpoint;
pub use bundle::DsseEnvelope;
pub use bundle::DsseSignature;
pub use bundle::InclusionPromise;
pub use bundle::InclusionProof;
pub use bundle::Rfc3161Timestamp;
pub use bundle::TimestampVerificationData;
pub use bundle::TlogEntry;
pub use bundle::VerificationMaterial;
pub use error::CertificateError;
pub use error::ContentBindingError;
pub use error::Error;
pub use error::ParseError;
pub use error::PolicyError;
pub use error::ResourceLimitError;
pub use error::TimestampError;
pub use error::TransparencyError;
pub use error::TrustError;
pub use error::UnsupportedError;
pub use policy::CheckpointOriginBinding;
pub use policy::CheckpointOriginPolicy;
pub use policy::CheckpointOriginPolicyBuilder;
pub use policy::CommitSha;
pub use policy::GithubPolicy;
pub use policy::GithubPolicyBuilder;
pub use policy::RefPolicy;
pub use policy::RepositoryIdentity;
pub use policy::SignerPolicy;
pub use policy::SourcePolicy;
pub use policy::WorkflowPath;
pub use policy::WorkflowRevisionPolicy;
pub use statement::STATEMENT_TYPE;
pub use statement::Statement;
pub use statement::StatementSubject;
pub use trust::CaSubject;
pub use trust::CertificateAuthority;
pub use trust::CtLog;
pub use trust::PublicKey;
pub use trust::TRUSTED_ROOT_MEDIA_TYPE;
pub use trust::TransparencyLog;
pub use trust::TrustStore;
pub use trust::ValidityPeriod;
pub use verifier::TrustSnapshotInfo;
pub use verifier::VerificationReport;
pub use verifier::VerifiedCertificateIdentity;
pub use verifier::VerifiedSignedStatement;
pub use verifier::VerifiedSubject;
pub use verifier::VerifiedTransparency;
pub use verifier::Verifier;
pub use verifier::VerifierBuilder;

Modules§

bundle
Sigstore bundle (application/vnd.dev.sigstore.bundle.v0.3+json) parsing, and the two multi-bundle container shapes GitHub actually serves them in.
error
Mechanical error taxonomy.
policy
GitHub identity policy types (DESIGN.md “Identity policy”).
statement
In-toto Statement v1 parsing (the decoded dsseEnvelope.payload).
trust
Trusted-root (application/vnd.dev.sigstore.trustedroot+json;version=0.1) parsing: Fulcio certificate authorities, Rekor transparency logs, Certificate Transparency logs, and timestamp authorities.
verifier
The verification entry point.

Structs§

Subject
A SHA-256 digest identifying the artifact bytes to verify.