docs: clarify the interaction of clientcert and cert auth.
authorBruce Momjian <bruce@momjian.us>
Mon, 5 Oct 2020 20:07:15 +0000 (16:07 -0400)
committerBruce Momjian <bruce@momjian.us>
Mon, 5 Oct 2020 20:07:15 +0000 (16:07 -0400)
This is the first paragraph change of master-only commit 253f1025da.

Backpatch-through: PG 12-13 only

doc/src/sgml/client-auth.sgml

index 5cd88b462dbdbf056d48331a1a9c4609033af03f..a0d584fb34eef2193cd4d0aae00e3d374631dacc 100644 (file)
@@ -2042,13 +2042,10 @@ host ... radius radiusservers="server1,server2" radiussecrets="""secret one"",""
    </para>
 
    <para>
-    In a <filename>pg_hba.conf</filename> record specifying certificate
-    authentication, the authentication option <literal>clientcert</literal> is
-    assumed to be <literal>verify-ca</literal> or <literal>verify-full</literal>,
-    and it cannot be turned off since a client certificate is necessary for this
-    method. What the <literal>cert</literal> method adds to the basic
-    <literal>clientcert</literal> certificate validity test is a check that the
-    <literal>cn</literal> attribute matches the database user name.
+    It is redundant to use the <literal>clientcert</literal> option with
+    <literal>cert</literal> authentication because <literal>cert</literal>
+    authentication is effectively <literal>trust</literal> authentication
+    with <literal>clientcert=verify-full</literal>.
    </para>
   </sect1>