v3.0.2

v3.0.2

v3.0.2 is a functionally equivalent release to v3.0.0 and v3.0.1, with a fix for CI to publish signed releases in the new bundle format.

• Note that the --bundle flag specifying an output file to write the Sigstore bundle (which contains all relevant verification material) has moved from optional to required in v3.

Changes

• choose different signature filename for KMS-signed release signatures (#4448)
• Update rekor-tiles version path (#4450)

v3.0.1

v3.0.1

v3.0.1 is an equivalent release to v3.0.0, which was never published due to a failure in our CI workflows.

• Note that the --bundle flag specifying an output file to write the Sigstore bundle (which contains all relevant verification material) has moved from optional to required in v3.

Changes

• update goreleaser config for v3.0.0 release (#4446)

v3.0.0

Announcing the next major release of Cosign!

Cosign v3 is a minor change from Cosign v2.6.x, with all of the new capabilities of recent
releases on by default, but will still allow you to disable them if you need the older functionality.
These new features include support for the standardized bundle format (--new-bundle-fomat), providing roots
of trust for verification and service URLs for signing via one file (--trusted-root, --signing-config),
and container signatures stored as an OCI Image 1.1 referring artifact.

Learn more on our v3 announcement blog post! See
the changelogs for v2.6.0, v2.5.0, and v2.4.0 for more information on recent
changes.

If you have any feedback, please reach out on Slack or file an issue on GitHub.

Changes

• Default to using the new protobuf format (#4318)
• Fetch service URLs from the TUF PGI signing config by default (#4428)
• Bump module version to v3 for Cosign v3.0 (#4427)

v2.6.1

Changelog

• 634fabe Bump sigstore-go, move conformance back to tagged release
• c5545ed Partially populate the output of cosign verify when working with new bundles (#4416)
• e191024 bump go builder to use 1.25.1 and cosign (#4417)

Thanks to all contributors!

v2.6.0

v2.6.0 introduces a number of new features, including:

• Signing an in-toto statement rather than Cosign constructing one from a predicate, along with verifying a statement's subject using a digest and digest algorithm rather than providing a file reference (#4306)
• Uploading a signature and its verification material (a "bundle") as an OCI Image 1.1 referring artifact, completing #3927 (#4316)
• Providing service URLs for signing and attesting using a SigningConfig. Note that this is required when using a Rekor v2 instance (#4319)

Example generation and verification of a signed in-toto statement:

cosign attest-blob --new-bundle-format=true --bundle="digest-key-test.sigstore.json" --key="cosign.key" --statement="../sigstore-go/examples/sigstore-go-signing/intoto.txt"
cosign verify-blob-attestation --bundle="digest-key-test.sigstore.json" --key=cosign.pub --type=unused --digest="b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9" --digestAlg="sha256"

Example container signing and verification using the new bundle format and referring artifacts:

cosign sign --new-bundle-format=true ghcr.io/user/alpine@sha256:a19367999603840546b8612572e338ec076c6d1f2fec61760a9e11410f546733
cosign verify --new-bundle-format=true ghcr.io/user/alpine@sha256:a19367999603840546b8612572e338ec076c6d1f2fec61760a9e11410f546733

Example usage of a signing config provided by the public good instance's TUF repository:

cosign sign-blob --use-signing-config --bundle sigstore.json README.md
cosign verify-blob --new-bundle-format --bundle sigstore.json --certificate-identity $EMAIL --certificate-oidc-issuer $ISSUER --use-signed-timestamps README.md

v2.6.0 leverages sigstore-go's signing and verification APIs gated behind these new flags. In an upcoming major release, we will be
updating Cosign to default to producing and consuming bundles to align with all other Sigstore SDKs.

Features

• Add to attest-blob the ability to supply a complete in-toto statement, and add to verify-blob-attestation the ability to verify with just a digest (#4306)
• Have cosign sign support bundle format (#4316)
• Add support for SigningConfig for sign-blob/attest-blob, support Rekor v2 (#4319)
• Add support for SigningConfig in sign/attest (#4371)
• Support self-managed keys when signing with sigstore-go (#4368)
• Don't require timestamps when verifying with a key (#4337)
• Don't load content from TUF if trusted root path is specified (#4347)
• Add a terminal spinner while signing with sigstore-go (#4402)
• Require exclusively a SigningConfig or service URLs when signing (#4403)
• Remove SHA256 assumption in sign-blob/verify-blob (#4050)
• Bump sigstore-go, support alternative hash algorithms with keys (#4386)

Breaking API Changes

• sign.SignerFromKeyOpts no longer generates a key. Instead, it returns whether or not the client needs to generate a key, and if so, clients
  should call sign.KeylessSigner. This allows clients to more easily manage key generation.

Bug Fixes

• Verify subject with bundle only when checking claims (#4320)
• Fixes to cosign sign / verify for the new bundle format (#4346)

Full Changelog: v2.5.3...v2.6.0

v2.5.3

Changelog

• 488ef8c Add signing-config create command (#4280)
• 722207e Allow multiple services to be specified for trusted-root create (#4285)
• 2ee22fc force when copying the latest image to overwrite (#4298)
• 86560e1 Fix cert verification logic for trusted-root/SCTs (#4294)
• 9f3b013 Fix lint error for types package (#4295)
• 3b3c0fc feat: Add OCI 1.1+ experimental support to tree (#4205)
• 49c8d78 Add validity period end for trusted-root create (#4271)
• ba8214e avoid double-loading trustedroot from file (#4264)

Thanks to all contributors!

v2.5.2

Changelog

• b126109 Do not load trusted root when CT env key is set
• 19ef59d docs: improve doc for --no-upload option (#4206)

Thanks to all contributors!

v2.5.1

v2.5.1

Features

• Add Rekor v2 support for trusted-root create (#4242)
• Add baseUrl and Uri to trusted-root create command
• Upgrade to TUF v2 client with trusted root
• Don't verify SCT for a private PKI cert (#4225)
• Bump TSA library to relax EKU chain validation rules (#4219)

Bug Fixes

• Bump sigstore-go to pick up log index=0 fix (#4162)
• remove unused recursive flag on attest command (#4187)

Docs

• Fix indentation in verify-blob cmd examples (#4160)

Releases

• ensure we copy the latest tags on each release (#4157)

v2.5.0

v2.5.0 includes an implementation of the new bundle specification,
attesting and verifying OCI image attestations uploaded as OCI artifacts.
This feature is currently gated behind the --new-bundle-format flag
when running cosign attest.

Features

• Add support for new bundle specification for attesting/verifying OCI image attestations (#3889)
• Feat/non filename completions (#4115)
• Add TSA certificate related flags and fields for cosign attest (#4079)

Fixes

• cmd/cosign/cli: fix typo in ignoreTLogMessage (#4111)
• Fix replace with compliant image mediatype (#4077)

v2.4.3

v2.4.3

Features

• Bump sigstore/sigstore to support KMS plugins (#4073)
• Enable fetching signatures without remote get. (#4047)
• Feat/file flag completion improvements (#4028)
• Update builder to use go1.23.6 (#4052)

Bug Fixes

• fix parsing error in --only for cosign copy (#4049)

Cleanup

• Refactor verifyNewBundle into library function (#4013)
• fix comment typo and imports order (#4061)
• sync comment with parameter name in function signature (#4063)
• sort properly Go imports (#4071)

Contributors

• Bob Callaway
• Carlos Tadeu Panato Junior
• Cody Soyland
• Dmitry Savintsev
• Hayden B
• Tomasz Janiszewski
• Ville Skyttä

v2.4.2

Features

• Updated open-policy-agent to 1.1.0 library (#4036)
  • Note that only Rego v0 policies are supported at this time
• Add UseSignedTimestamps to CheckOpts, refactor TSA options (#4006)
• Add support for verifying root checksum in cosign initialize (#3953)
• Detect if user supplied a valid protobuf bundle (#3931)
• Add a log message if user doesn't provide --trusted-root (#3933)
• Support mTLS towards container registry (#3922)
• Add bundle create helper command (#3901)
• Add trusted-root create helper command (#3876)

Bug Fixes

• fix: set tls config while retaining other fields from default http transport (#4007)
• policy fuzzer: ignore known panics (#3993)
• Fix for multiple WithRemote options (#3982)
• Add nightly conformance test workflow (#3979)
• Fix copy --only for signatures + update/align docs (#3904)

Documentation

• Remove usage.md from spec, point to client spec (#3918)
• move reference from gcr to ghcr (#3897)

Contributors

• AdamKorcz
• Aditya Sirish
• Bob Callaway
• Carlos Tadeu Panato Junior
• Cody Soyland
• Colleen Murphy
• Hayden B
• Jussi Kukkonen
• Marco Franssen
• Nianyu Shen
• Slavek Kabrda
• Søren Juul
• Warren Hodgkinson
• Zach Steindler