docs:smbdotconf: make formatting of headers uniform.
[Samba.git] / docs-xml / smbdotconf / security / authmethods.xml
bloba5e3a11caaf6fb8b81fc6de354f8c82a658ec2ca
1 <samba:parameter name="auth methods"
2                  context="G"
3                  type="list"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
7     <para>
8     This option allows the administrator to chose what authentication methods <command  moreinfo="none">smbd</command> 
9     will use when authenticating a user. This option defaults to sensible values based on <smbconfoption name="security"/>.  
10     This should be considered a developer option and used only in rare circumstances.  In the majority (if not all) 
11     of production servers, the default setting should be adequate.
12     </para>
14     <para>
15     Each entry in the list attempts to authenticate the user in turn, until
16     the user authenticates.  In practice only one method will ever actually 
17     be able to complete the authentication.
18     </para>
20     <para>
21     Possible options include <constant>guest</constant> (anonymous access), 
22     <constant>sam</constant> (lookups in local list of accounts based on netbios 
23     name or domain name), <constant>winbind</constant> (relay authentication requests
24     for remote users through winbindd), <constant>ntdomain</constant> (pre-winbindd 
25     method of authentication for remote domain users; deprecated in favour of winbind method), 
26     <constant>trustdomain</constant> (authenticate trusted users by contacting the 
27     remote DC directly from smbd; deprecated in favour of winbind method).
28     </para>
30 </description>
31 <value type="default"/>
32 <value type="example">guest sam winbind</value>
33 </samba:parameter>