Skip to content

web: add X25519MLKEM768 post-quantum curve to TLS config#417

Open
Thealisyed wants to merge 1 commit into
prometheus:masterfrom
Thealisyed:add-pqc-curve-x25519mlkem768
Open

web: add X25519MLKEM768 post-quantum curve to TLS config#417
Thealisyed wants to merge 1 commit into
prometheus:masterfrom
Thealisyed:add-pqc-curve-x25519mlkem768

Conversation

@Thealisyed

Copy link
Copy Markdown

Summary

Add the X25519MLKEM768 hybrid post-quantum key exchange to the supported curve_preferences map in web-config.yaml.

Motivation

X25519MLKEM768 (CurveID 4588) combines X25519 with ML-KEM-768 (FIPS 203). Go 1.24+ includes it in the default TLS 1.3 key exchange preferences when CurvePreferences is nil. However, users who explicitly set curve_preferences in their web config to control which key exchanges are offered cannot currently include X25519MLKEM768, which effectively disables post-quantum key exchange for those deployments.

This is particularly relevant for projects like Prometheus exporters running in environments with post-quantum cryptography mandates (e.g., OpenShift, which enforces centralized TLS security profiles).

Changes

  • web/tls_config.go: Add X25519MLKEM768 to the curves map
  • web/testdata/web_config_noAuth_allCurves.good.yml: Add to test fixture
  • docs/web-configuration.md: Update description to cover non-ECDHE key exchanges

Notes

  • Go 1.26 will add SecP256r1MLKEM768 and SecP384r1MLKEM1024. Those can be added in a follow-up when this module bumps its Go version requirement.
  • X25519MLKEM768 is TLS 1.3 only. If configured with min_version: TLS12, Go will silently skip it during TLS 1.2 handshakes — no error, it just won't be negotiated. This is the same behavior as the existing curves.

Signed-off-by: Ali Syed alsyed@redhat.com

X25519MLKEM768 is a hybrid post-quantum key exchange combining X25519
with ML-KEM-768. It has been available since Go 1.24 and is enabled by
default in TLS 1.3, but users who explicitly set curve_preferences
cannot currently include it.

Assisted-by: Claude
Signed-off-by: Ali Syed <alsyed@redhat.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant