docs-xml: Update documentation for 'restrict anonymous' option
authorAndreas Schneider <asn@samba.org>
Tue, 5 Feb 2019 15:08:46 +0000 (16:08 +0100)
committerDavid Disseldorp <ddiss@samba.org>
Thu, 7 Feb 2019 16:23:18 +0000 (17:23 +0100)
Signed-off-by: Andreas Schneider <asn@samba.org>
Reviewed-by: Rowland Penny <rpenny@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>
docs-xml/smbdotconf/security/restrictanonymous.xml

index 78cafd2..06abe7b 100644 (file)
@@ -3,34 +3,35 @@
                  context="G"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-    <para>The setting of this parameter determines whether user and
-    group list information is returned for an anonymous connection.
-    and mirrors the effects of the
-<programlisting>
-HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
-           Control\LSA\RestrictAnonymous
-</programlisting>
-       registry key in Windows 2000 and Windows NT.  When set to 0, user
-       and group list information is returned to anyone who asks.  When set
-    to 1, only an authenticated user can retrieve user and
-    group list information.  For the value 2, supported by
-    Windows 2000/XP and Samba, no anonymous connections are allowed at
-    all.  This can break third party and Microsoft
-    applications which expect to be allowed to perform
-       operations anonymously.</para>
+       <para>
+               The setting of this parameter determines whether SAMR and LSA
+               DCERPC services can be accessed anonymously. This corresponds
+               to the following Windows Server registry options:
+       </para>
+
+       <programlisting>
+               HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\RestrictAnonymous
+       </programlisting>
+
+       <para>
+               The option also affects the browse option which is required by
+               legacy clients which rely on Netbios browsing. While modern
+               Windows version should be fine with restricting the access
+               there could still be applications relying on anonymous access.
+       </para>
 
        <para>
-    The security advantage of using restrict anonymous = 1 is dubious,
-    as user and group list information can be obtained using other
-       means.
+               Setting <smbconfoption name="restrict anonymous">1</smbconfoption>
+               will disable anonymous SAMR access.
        </para>
 
-       <note>
        <para>
-    The security advantage of using restrict anonymous = 2 is removed
-    by setting <smbconfoption name="guest ok">yes</smbconfoption> on any share.
+               Setting <smbconfoption name="restrict anonymous">2</smbconfoption>
+               will, in addition to restricting SAMR access, disallow anonymous
+               connections to the IPC$ share in general.
+               Setting <smbconfoption name="guest ok">yes</smbconfoption> on any share
+               will remove the security advantage.
        </para>
-       </note>
 </description>
 
 <value type="default">0</value>