Next update of VFS modules development guide
[vlendec/samba-autobuild/.git] / docs-xml / smbdotconf / security / encryptpasswords.xml
1 <samba:parameter name="encrypt passwords"
2                  context="G"
3                                  type="boolean"
4                  basic="1" advanced="1" wizard="1" developer="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>This boolean controls whether encrypted passwords 
8     will be negotiated with the client. Note that Windows NT 4.0 SP3 and 
9     above and also Windows 98 will by default expect encrypted passwords 
10     unless a registry entry is changed. To use encrypted passwords in 
11     Samba see the chapter "User Database" in the Samba HOWTO Collection.
12     </para>
13
14     <para>
15     MS Windows clients that expect Microsoft encrypted passwords and that
16     do not have plain text password support enabled will be able to
17     connect only to a Samba server that has encrypted password support
18     enabled and for which the user accounts have a valid encrypted password.
19     Refer to the smbpasswd command man page for information regarding the
20     creation of encrypted passwords for user accounts.
21     </para>
22
23     <para>
24     The use of plain text passwords is NOT advised as support for this feature
25     is no longer maintained in Microsoft Windows products. If you want to use
26     plain text passwords you must set this parameter to no.
27     </para>
28
29     <para>In order for encrypted passwords to work correctly
30     <citerefentry><refentrytitle>smbd</refentrytitle>
31     <manvolnum>8</manvolnum></citerefentry> must either 
32     have access to a local <citerefentry><refentrytitle>smbpasswd</refentrytitle>
33     <manvolnum>5</manvolnum></citerefentry> file (see the <citerefentry><refentrytitle>smbpasswd</refentrytitle>
34     <manvolnum>8</manvolnum></citerefentry> program for information on how to set up 
35     and maintain this file), or set the <smbconfoption name="security">[server|domain|ads]</smbconfoption> parameter which 
36     causes <command moreinfo="none">smbd</command> to authenticate against another 
37         server.</para>
38 </description>
39 <value type="default">yes</value>
40 </samba:parameter>