Skip to content

docs: Update provenance guide for modern GnuPG keybox/armored keyring verification#2162

Draft
promptless-for-oss wants to merge 1 commit into
helm:mainfrom
Promptless:promptless/document-modern-gnupg-keybox-verification
Draft

docs: Update provenance guide for modern GnuPG keybox/armored keyring verification#2162
promptless-for-oss wants to merge 1 commit into
helm:mainfrom
Promptless:promptless/document-modern-gnupg-keybox-verification

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Replaces the stale warning in the provenance guide that told users to convert their modern GnuPG keybox (pubring.kbx) to the legacy pubring.gpg format. Helm now auto-detects keybox and ASCII-armored public keyrings during verification, so no conversion is required; only the signing side still needs a binary secret keyring. Reflects helm/helm#32281.

Trigger Events


Tip: Connect Jira, Linear, Confluence, and more in Integrations to enrich suggestion quality 🔗

…verification

Helm now auto-detects keybox (pubring.kbx) and ASCII-armored public
keyrings during verification, so converting to the legacy pubring.gpg
format is no longer required. Signing still needs a binary secret
keyring. Reflects helm/helm#32281.

Signed-off-by: promptless[bot] <promptless[bot]@users.noreply.github.com>
**Warning:** the GnuPG v2 store your secret keyring using a new format `kbx` on
the default location `~/.gnupg/pubring.kbx`. Please use the following command
to convert your keyring to the legacy gpg format:
**Note:** Since GnuPG v2.1, public keys are stored in a keybox file

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rewrote the note based on PR #32281, which makes loadKeyRing (pkg/provenance/sign.go) format-aware so verification auto-detects keybox (pubring.kbx), ASCII-armored (gpg --export --armor), and legacy binary keyrings — removing the need to convert to pubring.gpg. defaultKeyring() in pkg/cmd/dependency_build.go now falls back to pubring.kbx. The PR scope is public-keyring reads (verification) only; the --sign secret-key path is unchanged, so the guidance to export a binary secret keyring for signing stays.

Source: helm/helm#32281

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant