summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Eisentraut <peter@eisentraut.org>2020-07-23 17:13:00 +0200
committerPeter Eisentraut <peter@eisentraut.org>2020-07-23 20:41:55 +0200
commiteb8e2ccbb2a0672a7b301f232affc5ec765d9d31 (patch)
tree817fe689dbe6bb830c633f32c8735aa07677734e
parentfac4145bf43ae332e377a37d8e1dc99c7eb3d975 (diff)
doc: Document that ssl_ciphers does not affect TLS 1.3
TLS 1.3 uses a different way of specifying ciphers and a different OpenSSL API. PostgreSQL currently does not support setting those ciphers. For now, just document this. In the future, support for this might be added somehow. Reviewed-by: Jonathan S. Katz <jkatz@postgresql.org> Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
-rw-r--r--doc/src/sgml/config.sgml26
1 files changed, 16 insertions, 10 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 4fe11cdf159..d96acf1d3ff 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -1067,16 +1067,22 @@ include_dir 'conf.d'
</term>
<listitem>
<para>
- Specifies a list of <acronym>SSL</> cipher suites that are allowed to be
- used on secure connections. See
- the <citerefentry><refentrytitle>ciphers</></citerefentry> manual page
- in the <application>OpenSSL</> package for the syntax of this setting
- and a list of supported values.
- This parameter can only be set in the <filename>postgresql.conf</>
- file or on the server command line.
- The default value is <literal>HIGH:MEDIUM:+3DES:!aNULL</>. The
- default is usually a reasonable choice unless you have specific
- security requirements.
+ Specifies a list of <acronym>SSL</> cipher suites that are
+ allowed to be used by SSL connections. See the
+ <citerefentry><refentrytitle>ciphers</></citerefentry>
+ manual page in the <application>OpenSSL</> package for the
+ syntax of this setting and a list of supported values. Only
+ connections using TLS version 1.2 and lower are affected. There is
+ currently no setting that controls the cipher choices used by TLS
+ version 1.3 connections. The default value is
+ <literal>HIGH:MEDIUM:+3DES:!aNULL</>. The default is usually a
+ reasonable choice unless you have specific security requirements.
+ </para>
+
+ <para>
+ This parameter can only be set in the
+ <filename>postgresql.conf</> file or on the server command
+ line.
</para>
<para>