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
Subject: the artifact digest being verified.Bundle/BundleSet: parsed Sigstore bundles, and the two container shapes GitHub serves them in.Statement: the in-toto statement inside a bundle’s DSSE payload.TrustStore: a parsed trusted-root document.GithubPolicy: the identity policy aVerifierenforces.CheckpointOriginPolicy: exact signed checkpoint origins bound to trusted log-key SPKI digests.Verifier: the verification entry point;Verifier::verify_digest/Verifier::verify_bytesreturn averifier::VerificationReporton success.
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.