docs:smbdotconf: make formatting of headers uniform.
[gd/samba-autobuild/.git] / docs-xml / smbdotconf / security / serversigning.xml
1 <samba:parameter name="server signing"
2                  context="G"
3                  type="enum"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6
7     <para>This controls whether the client is allowed or required to use SMB1 and SMB2 signing. Possible values
8     are <emphasis>default</emphasis>, <emphasis>auto</emphasis>, <emphasis>mandatory</emphasis>
9     and <emphasis>disabled</emphasis>.
10     </para>
11
12     <para>By default, and when smb signing is set to
13     <emphasis>default</emphasis>, smb signing enabled when
14     <smbconfoption name="server role"/> is <emphasis>active directory
15     domain controller</emphasis> and disabled otherwise.</para>
16
17     <para>When set to auto, SMB1 signing is offered, but not enforced.
18     When set to mandatory, SMB1 signing is required and if set
19     to disabled, SMB signing is not offered either.</para>
20
21     <para>For the SMB2 protocol, by design, signing cannot be disabled. In the case
22     where SMB2 is negotiated, if this parameter is set to <emphasis>disabled</emphasis>,
23     it will be treated as <emphasis>auto</emphasis>. Setting it to <emphasis>mandatory</emphasis>
24     will still require SMB2 clients to use signing.</para>
25 </description>
26
27 <value type="default">default</value>
28 </samba:parameter>