Skip to content

Document ML-DSA (post-quantum) private keys - #2332

Open
FelixPhipps wants to merge 2 commits into
cert-manager:release-nextfrom
FelixPhipps:mldsa-docs
Open

FelixPhipps wants to merge 2 commits into
cert-manager:release-nextfrom
FelixPhipps:mldsa-docs

Conversation

@FelixPhipps

@FelixPhipps FelixPhipps commented Oct 15, 2026 •

Copy link
Copy Markdown
Member

Documents ML-DSA (post-quantum) private keys, added in cert-manager/cert-manager#9469 (design: cert-manager/cert-manager#9436, tracking issue: cert-manager/cert-manager#8929). The feature is alpha in v1.22, behind the MLDSAPrivateKeys feature gate.

Important

Please merge this only after cert-manager/cert-manager#9469 has merged, so the docs match the released behaviour.

  • New guide, docs/usage/post-quantum.md, covering:
    • how ML-DSA works in cert-manager: sizes, signatureAlgorithm, seed-only keys and key usages
    • supported issuers and limitations
    • enabling the feature gate, and what each component does when it's off
    • an example ML-DSA chain from root to leaf
    • Ingress and Gateway annotations, keystores, bringing your own CA key, and Kubernetes CertificateSigningRequests
    • a consumer compatibility matrix, from testing on 2026-10-15
    • a parallel canary migration and rollback guide
  • Updated pages:
    • MLDSA in the annotation reference and the Ingress and Gateway pages
    • ML-DSA default and forbidden key usages on the Certificate page
    • the kube CSR page
    • feature gate configuration examples

npm run check passes.

@cert-manager-prow cert-manager-prow Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. labels Oct 15, 2026
@cert-manager-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign thatsmrtalbot for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@cert-manager-prow cert-manager-prow Bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Oct 15, 2026
@netlify

netlify Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for cert-manager ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 62c25ab
🔍 Latest deploy log https://app.netlify.com/projects/cert-manager/deploys/6ad5fb076f363182b13ace24
😎 Deploy Preview https://deploy-preview-2332--cert-manager.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@FelixPhipps
FelixPhipps marked this pull request as ready for review October 15, 2026 14:45
@cert-manager-prow cert-manager-prow Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 15, 2026
Add a post-quantum guide covering the MLDSA private key algorithm, the
MLDSAPrivateKeys feature gate, supported issuers and limitations, a
consumer compatibility matrix, a parallel canary migration and rollback.
Document MLDSA in the Ingress and Gateway annotations, the Certificate
key usages, Kubernetes CertificateSigningRequests and the feature gate
configuration examples.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Felix Phipps <fphipps@paloaltonetworks.com>
@cert-manager-prow cert-manager-prow Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Oct 15, 2026
A CA issuer with an ML-DSA CA key is now not Ready while the
MLDSAPrivateKeys gate is off, and CertificateRequests stopped by the
gate stay pending instead of failing (cert-manager/cert-manager#9469).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Felix Phipps <fphipps@paloaltonetworks.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant