1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-05 09:18:06 +03:00
samba-mirror/docs-xml/smbdotconf/ldap/ldapssl.xml
Karolin Seeger a592bdc51c docs: Add missing spaces in man smb.conf.
Signed-off-by: Karolin Seeger <kseeger@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>

Autobuild-User(master): Jeremy Allison <jra@samba.org>
Autobuild-Date(master): Thu Feb  9 23:58:02 CET 2017 on sn-devel-144
2017-02-09 23:58:02 +01:00

49 lines
1.9 KiB
XML

<samba:parameter name="ldap ssl"
context="G"
type="enum"
enumlist="enum_ldap_ssl"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>This option is used to define whether or not Samba should
use SSL when connecting to the ldap server
This is <emphasis>NOT</emphasis> related to
Samba's previous SSL support which was enabled by specifying the
<command moreinfo="none">--with-ssl</command> option to the
<filename moreinfo="none">configure</filename>
script.</para>
<para>LDAP connections should be secured where possible. This may be
done setting <emphasis>either</emphasis> this parameter to
<parameter moreinfo="none">start tls</parameter>
<emphasis>or</emphasis> by specifying <parameter moreinfo="none">ldaps://</parameter> in
the URL argument of <smbconfoption name="passdb backend"/>.</para>
<para>The <smbconfoption name="ldap ssl"/> can be set to one of
two values:</para>
<itemizedlist>
<listitem>
<para><parameter moreinfo="none">Off</parameter> = Never
use SSL when querying the directory.</para>
</listitem>
<listitem>
<para><parameter moreinfo="none">start tls</parameter> = Use
the LDAPv3 StartTLS extended operation (RFC2830) for
communicating with the directory server.</para>
</listitem>
</itemizedlist>
<para>
Please note that this parameter does only affect <emphasis>rpc</emphasis>
methods. To enable the LDAPv3 StartTLS extended operation (RFC2830) for
<emphasis>ads</emphasis>, set
<smbconfoption name="ldap ssl">start tls</smbconfoption>
<emphasis>and</emphasis>
<smbconfoption name="ldap ssl ads">yes</smbconfoption>.
See <refentrytitle>smb.conf</refentrytitle><manvolnum>5</manvolnum>
for more information on <smbconfoption name="ldap ssl ads"/>.
</para>
</description>
<value type="default">start tls</value>
</samba:parameter>