Skip to content

web: mark prefer_server_cipher_suites as deprecated and ignored - #444

Merged
ArthurSens merged 1 commit into
prometheus:masterfrom
mrueg:docs/deprecate-prefer-server-cipher-suites
Sep 3, 2026
Merged

web: mark prefer_server_cipher_suites as deprecated and ignored#444
ArthurSens merged 1 commit into
prometheus:masterfrom
mrueg:docs/deprecate-prefer-server-cipher-suites

Conversation

@mrueg

@mrueg mrueg commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

The documentation gives prefer_server_cipher_suites a four-line explanation of how it changes cipher selection, and it has not done anything for years.

It is passed to tls.Config.PreferServerCipherSuites, whose own documentation reads:

PreferServerCipherSuites is a legacy field and has no effect.

Go has selected the cipher suite itself since Go 1.17. Operators tuning this are tuning a knob that is not connected to anything.

Change

Say so in the documentation and on the struct field, and stop passing the value to tls.Config — which also removes a use of a deprecated standard library field. The YAML key is still parsed and still defaults to true, so existing configuration files keep loading unchanged.

🤖 Generated with Claude Code

The documentation gives this setting a four line explanation of how it
changes cipher selection, and it has not done anything for years. It was
passed to tls.Config.PreferServerCipherSuites, whose own documentation
reads "PreferServerCipherSuites is a legacy field and has no effect"; Go
has selected the cipher suite itself since Go 1.17. Operators tuning it are
tuning a knob that is not connected to anything.

Say so in the documentation and on the struct field, and stop passing the
value to tls.Config, which also removes a use of a deprecated standard
library field. The YAML key is still parsed and still defaults to true, so
existing configuration files keep loading unchanged.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Manuel Rüger <manuel@rueg.eu>

@ArthurSens ArthurSens left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks!

@ArthurSens
ArthurSens merged commit 975cc55 into prometheus:master Sep 3, 2026
6 checks passed
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.

2 participants