docs: update signature verification for cosign v3 bundles - #567
Open
FreyreCorona wants to merge 2 commits into
Open
docs: update signature verification for cosign v3 bundles#567FreyreCorona wants to merge 2 commits into
FreyreCorona wants to merge 2 commits into
Conversation
mohammed90
requested changes
Aug 28, 2026
mohammed90
left a comment
Member
There was a problem hiding this comment.
Please rewrite it with human touch. LLMs tend to obsess over the exact changes and gets hung on "with the Cosign v3" and "now that we're adopting Cosign v3".
Also, the steps don't apply to Caddy v2.6 because the signature file format is different.
Make it generic. "Cosign v3" is not the subject of this article. Verifying signatures is.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Update the signature verification article to reflect the Cosign v3 signing flow introduced in caddyserver/caddy#7674.
What changed
Cosign v3 replaces the detached signature (
<artifact>.sig) and certificate (<artifact>.pem) files with a single unified bundle (<artifact>.sigstore.json) containing the signature, the Fulcio certificate, and the transparency log entry.verificationMaterial.certificate.rawBytes) for inspection withopenssl.COSIGN_EXPERIMENTAL=1 cosign verify-blobwith the v3 keyless flow, which enforces tri-leg verification (signature, certificate identity, and transparency log) in a single command using--bundleplus--certificate-identityand--certificate-oidc-issuer.rekor-cli searchinstead.Assistance Disclosure: This was created with the assistance of opencode/big-pickle.