Document that LDAP URLs should be double-quoted in pg_hba.conf because

commas are often present in the URL.

Backpatch to 8.2.X.
This commit is contained in:
Bruce Momjian 2007-03-24 21:46:25 +00:00
parent 1e0cba90fd
commit 720a9cc0e5

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.96 2006/11/23 05:39:17 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.96.2.1 2007/03/24 21:46:25 momjian Exp $ -->
<chapter id="client-authentication">
<title>Client Authentication</title>
@ -929,9 +929,13 @@ omicron bryanh guest1
<synopsis>
ldap[<replaceable>s</>]://<replaceable>servername</>[:<replaceable>port</>]/<replaceable>base dn</replaceable>[;<replaceable>prefix</>[;<replaceable>suffix</>]]
</synopsis>
for example:
Commas are used to specify multiple items in an <literal>ldap</>
component. However, because unquoted commas are treated as item
separators in <filename>pg_hba.conf</filename>, it is wise to
double-quote the <literal>ldap</> URL to preserve any commas present,
e.g.:
<synopsis>
ldap://ldap.example.net/dc=example,dc=net;EXAMPLE\
"ldap://ldap.example.net/dc=example,dc=net;EXAMPLE\"
</synopsis>
</para>