What's Changed

This release resolves GHSA-fx35-mq7g-6g98, a verification bypass using an unexpected public key in a legacy bundle.

• Auto-detect default digest algorithm for public keys in #5019
• fix(pkcs11key): return an error instead of panicking when no key pair matches in #5022
• Supporting OCI Signing with X.509 Certificate Chain in #4614
• test(inspect): replace mock TSA client usage with local timestamp response generator in #5021
• fix: prevent shell completions for various options not taking filenames in #5032
• fix(blob): compare file checksums case-insensitively in #5036
• Verification bypass via public key in legacy bundle (GHSA-fx35-mq7g-6g98) in #5040

Full Changelog: v3.1.2...v3.1.3

Changelog

This release backports GHSA-fx35-mq7g-6g98 (Verification bypass via public key in legacy bundle) to Cosign v2.6.x.

We strongly encourage folks to continue their migration to the bundle format. The Cosign v3.1.x releases support both formats; the primary change being that the default for signing is the bundle format (although you can specify --new-bundle-format=false to sign with the old format). The verification commands in Cosign v3.1.x support both formats, and will try to detect the format for you for maximum compatibility.

Thanks to all contributors!

This may be the last Cosign v3.1 release, as we finish deprecations and removing unused functionality. Soon we'll start work on Cosign v4 where we will remove things that are currently deprecated. We'll continue to support Cosign v3, with it's opt-in backwards compatibility, as described in our versioning policy.

If you haven't already, now is an excellent time to move to the bundle format that has been supported since Cosign v2.6.

We have received a ton of fixes over the past month from folks using Cosign in a variety of environments - thank you all!

Deprecations

• 816f2b6 Deprecate --payload for sign and verify commands (#4991)

Features

• 5121398 docs: add OVHcloud KMS in available external plugins (#4962)
• 38f73bb Add insecure registry flag to ko publish in kind-verify-attestation workflow (#4970)
• 2e0749a Deprecate --output-attestation (#4958)
• 2233166 Add bundle inspect command (#4842)

Fixes

• eb3bb86 Guard against empty certificate PEM in mutate.Signature (#4998)
• 089731c fix(download): Validate predicate type for new bundle format
• d996ce1 Skip nil subject entries in IntotoSubjectClaimVerifier (#5016)
• 8ca5b20 Fix Makefile: fall back to "unknown" version info when built outside a git repo (#5000)
• df78bf6 fix(verify): skip identity validation for security keys (#5012)
• aebdc3a fix: include artifactType in OCI 1.1 signature referrer manifest
• c0edaac Allow attestation download to handle both bundle types (#4996)
• a8642c7 Fix panic in dockerfile verify on malformed FROM lines (#4979)
• ef3e3b4 fix(release): restore signing-step auth and fail on image signing errors (#4978)
• 16ddbcf feat(signing-config): add --base-config flag to override services from base config (#4977)
• f17f812 fix: pass NewBundleFormat to KeyOpts in sign command (#4981)
• 6ef8d9d fix: ignore build stage references in dockerfile verify (#4961)
• 8dbdef5 fix: allow '=' in annotation values (#4957)

Cleanup

• 193d215 Remove unused policy evaluation code (#4936)
• 0fc9811 Remove unused signing code (#4918)
• 95dceda Remove unused OCI code (#4935)
• b1dd2e9 Remove unused ephemeral signer (#4938)

Documentation

• 8184126 feat: improve verify flag shell completions (#4965)
• ed0efe8 docs: fix Short style and add Example fields to piv-tool subcommands (#4942)
• d41b86c docs: add Example fields to env and bundle create commands (#4941)
• 8a7174a docs: fix Short style and add Example fields to pkcs11-tool subcommands

Thanks to all contributors!

This release is a backport of OCI manifest fixes, and better support for cosign attestation download when you are using a mix of old Cosign signatures with the more recent bundle format.

We strongly encourage folks to continue their migration to the bundle format. The Cosign v3.1.x releases support both formats; the primary change being that the default for signing is the bundle format (although you can specify --new-bundle-format=false to sign with the old format). The verification commands in Cosign v3.1.x support both formats, and will try to detect the format for you for maximum compatibility.

Changelog

• 26261f0 Allow attestation download to handle both bundle types (#4996) (#5017)
• d49a0c1 fix: include artifactType in OCI 1.1 signature referrer manifest (cherry-pick PR-4997 to release-2.6) (#5002)

Thanks to all contributors!

What's Changed

Note: v3.1.0 was skipped due to a bug in our release pipeline. v3.1.1 is identical to v3.1.0

This release deprecates a number of flags related to verification material input for trust root material, as well as the bundle format, standardized across Sigstore SDKs, which is now the default output and input for signing and verifying respectively. You may continue to use the deprecated flags with Cosign v3.x releases. The deprecated flags will be removed in a future Cosign v4 release.

This release also updates the signing path for logging to Rekor v2. DSSE attestations will be logged as hashed entries, using the DSSE's pre-auth encoding (PAE). This should unblock developers who want to upload large signed DSSEs such as SBOMs.

• Initialize PKCS11 slots Before Getting Token Info in #4803
• Sign exclusively via sigstore-go in #4618
• bundle create: Prevent IgnoreTlog when bundle contains SET in #4829
• Require bundle output or registry upload in #4785
• fix(load): pass NameOptions to name.ParseReference in #4786
• fix: honor --digestAlg when hashing a blob in verify-blob-attestation in #4813
• Deprecate Flags for v4: Certificates in #4822
• Deprecate flags signing config in #4844
• Deprecate flags bundle in #4838
• Fix typo in map of verify command fields unsupported for new bundle format in #4853
• Add bundle upgrade command in #4820
• Deprecate Flags for v4 in #4854
• fix: close file descriptor leaked in WriteSignedImageIndexImages loop in #4869
• fix: use Header.Set to prevent duplicate Authorization on retry in #4870
• feat(cli): add Rekor v2 flag to cosign signing-config create in #4868
• Fix crash verifying timestamps when no timestamp was verified in #4881
• Deprecate Flags for v4: OCI Referrers in #4804
• Use the configured Target Repository more consistently in #4836
• fix: check HTTP status code in LoadFileOrURL in #4877
• Fix unsafe type assertion in Rego policy evaluation by in #4882
• Fix Ed25519ph check to respect custom signing configs in sign-blob in #4880
• Enable initialize command output in conformance in #4892
• verify: return TUF errors for new bundle trusted roots in #4878
• Deprecate subcommands in #4894
• Remove docstring references to deprecated flags in #4910
• fix(verify): Attach detached certificates to static signatures via wrapped verifier in #4737
• fix(verify): copy CheckOpts inside VerifyNewBundle to fix data race in #4917
• Update sigstore-go to v1.2.0 in #4914

Full Changelog: v3.0.6...v3.1.1

Changelog

v3.0.6 resolves GHSA-w6c6-c85g-mmv6. This release also adds support for signing with OpenBao-managed keys.

• f1ad3ee Fix DSSE predicate check (GHSA-w6c6-c85g-mmv6) (#4801)
• a09afa9 Handle whitespace-only certificate annotation (#4760)
• 5a38a6d fix(sign): closing SignerVerifier too early when signing with a security key (#4761)
• 2290a59 Disallow --new-bundle-format and --rfc3161-timestamp (#4762)
• 36f4008 support managed keys in conformance testing (#4728)
• 3274cf9 Add support for GCE metadata server env var (#4732)
• 2e9754a fix: preserve per-layer annotations in WriteAttestationsReferrer (#4709)
• dece275 Fix parsing of in-toto for string predicates
• bd4f0fd Mark batch of flags for deprecation (#4698)
• 9b259ff disallow key and cert identity being used together during verification (#4636)
• 95eb1c3 support key creation in GitLab group (#4704)

Thanks to all contributors!

Changelog

v2.6.3 resolves GHSA-w6c6-c85g-mmv6.

• fecddd3 Fix DSSE predicate check (#4802)
• 564c5b1 Backport bundle detection to sign and attest (#4727)

Thanks to all contributors!

v3.0.5

v3.0.5 resolves a low-severity advisory for private PKIs.

Deprecations

• Deprecate rekor-entry-type flag (#4691)
• Deprecate cosign triangulate (#4676)
• Deprecate cosign copy (#4681)

Features

• Automatically require signed timestamp with Rekor v2 entries (#4666)
• Allow --local-image with --new-bundle-format for v2 and v3 signatures (#4626)
• Add mTLS support for TSA client connections when signing with a signing config (#4620)
• Enforce TSA requirement for Rekor v2, Fuclio signing (#4683)

Bug Fixes

• Add empty predicate to cosign sign when payload type is application/vnd.in-toto+json (#4635)
• fix: avoid panic on malformed attestation payload (#4651)
• fix: avoid panic on malformed tlog entries (#4649)
• fix: avoid panic on malformed replace payload (#4653)
• Gracefully fail if bundle payload body is not a string (#4648)
• Verify validity of chain rather than just certificate (#4663)
• fix: avoid panic on malformed tlog entry body (#4652)

Documentation

• docs(cosign): clarify RFC3161 revocation semantics (#4642)
• Fix typo in CLI help (#4701)

Full Changelog: v3.0.4...v3.0.5

New Contributors

• @dortam888 made their first contribution in #4635
• @1seal made their first contribution in #4642
• @tuminoid made their first contribution in #4626
• @Silvanoc made their first contribution in #4701

v3.0.4

v3.0.4 resolves GHSA-whqx-f9j3-ch6m.

Changes

• Fix bundle verify path for old bundle/trusted root (GHSA-whqx-f9j3-ch6m) (#4623)
• Optimize cosign tree performance by caching digest resolution (#4612)
• Don't require a trusted root to verify offline with a key (#4613)
• Support default services for trusted-root and signing-config creation (#4592)

Full Changelog: v3.0.3...v3.0.4

Changelog

v2.6.2 contains a fix for GHSA-whqx-f9j3-ch6m

• 3ade80c Fix bundle verify path for old bundle/trusted root (#4624)
• c4e6a78 v2.6 branch - bump sigstore deps (#4619)

Thanks to all contributors!