openssl-config: add example libssl system-defaults
authorBenjamin Kaduk <bkaduk@akamai.com>
Fri, 24 Jan 2020 01:08:34 +0000 (17:08 -0800)
committerBenjamin Kaduk <kaduk@mit.edu>
Sat, 25 Jan 2020 04:52:38 +0000 (20:52 -0800)
Provide a "simple" example for affecting the systemwide default behavior
of libssl.  The large number of mandatory nested sections makes this
less simple than the main description might suggest.

Reviewed-by: Richard Levitte <levitte@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/10937)

doc/man5/config.pod

index 1776439edd2e7a4df0cf33e913c15acfcf3dd6b1..680ad6578a9685b30524e5c02e59742b0c7ab0bc 100644 (file)
@@ -469,6 +469,22 @@ Simple OpenSSL library configuration example to enter FIPS mode:
 Note: in the above example you will get an error in non FIPS capable versions
 of OpenSSL.
 
+Simple OpenSSL library configuration to make TLS 1.3 the system-default
+minimum TLS version:
+
+ # Toplevel section for openssl (including libssl)
+ openssl_conf = default_conf_section
+
+ [default_conf_section]
+ # We only specify configuration for the "ssl module"
+ ssl_conf = ssl_section
+
+ [ssl_section]
+ system_default = system_default_section
+
+ [system_default_section]
+ MinProtocol = TLSv1.3
+
 More complex OpenSSL library configuration. Add OID and don't enter FIPS mode:
 
  # Default appname: should match "appname" parameter (if any)