docs-xml/smbdotconf/security/updateencrypted.xml

   1 <samba:parameter name="update encrypted"
   2                  context="G"
   3                                  type="boolean"
   4                  basic="1" advanced="1" developer="1"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7
   8     <para>
   9         This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
  10         password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
  11         migrate from plaintext password authentication (users authenticate with plaintext password over the
  12         wire, and are checked against a UNIX account atabase) to encrypted password authentication (the SMB
  13         challenge/response authentication mechanism) without forcing all users to re-enter their passwords via
  14         smbpasswd at the time the change is made. This is a convenience option to allow the change over to encrypted
  15         passwords to be made over a longer period.  Once all users have encrypted representations of their passwords
  16         in the smbpasswd file this parameter should be set to <constant>no</constant>.
  17         </para>
  18
  19     <para>
  20         In order for this parameter to be operative the <smbconfoption name="encrypt passwords"/> parameter must
  21     be set to <constant>no</constant>. The default value of <smbconfoption name="encrypt
  22         passwords">Yes</smbconfoption>. Note: This must be set to <constant>no</constant> for this <smbconfoption
  23         name="update encrypted"/> to work.
  24         </para>
  25
  26     <para>
  27         Note that even when this parameter is set a user authenticating to <command moreinfo="none">smbd</command>
  28         must still enter a valid password in order to connect correctly, and to update their hashed (smbpasswd)
  29         passwords.
  30         </para>
  31 </description>
  32
  33 <value type="default">no</value>
  34 </samba:parameter>