I'm writing today to seek comments on a doc change around the global parameter tune.ssl.keylog.

configuration.txt says "This option activates the logging of the TLS keys." but that isn't quite the case. This option facilitates data collection by several listed fetches and by itself does not generate any new logging. Some users might expect new log output by enabling this option, leading to confusion.

My recommendation is to change the language to be more explicit, like "This option is required for the below listed fetches which facilitate logging secrets for TLS 1.3. It should be used with care as it will consume more memory per SSL session and could decrease performances. This is disabled by default."

Later it is mentioned "If you want to generate the content of a SSLKEYLOGFILE with TLS < 1.3, you only need this line:" but it is not clear that those two listed fetches do not require tune.ssl.keylog.

I would like to add a clarifying statement after the CLIENT_RANDOM example like "These fetches do not require tune.ssl.keylog."

--
Daniel Epperson
Sr. Systems Engineer
https://www.haproxy.com/


Reply via email to