docs/docbook/smbdotconf/security/passwordlevel.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="PASSWORDLEVEL"/>password level (G)</term>
   3                 <listitem><para>Some client/server combinations have difficulty
   4                 with mixed-case passwords.  One offending client is Windows for
   5                 Workgroups, which for some reason forces passwords to upper
   6                 case when using the LANMAN1 protocol, but leaves them alone when
   7                 using COREPLUS!  Another problem child is the Windows 95/98
   8                 family of operating systems.  These clients upper case clear
   9                 text passwords even when NT LM 0.12 selected by the protocol
  10                 negotiation request/response.</para>
  11
  12                 <para>This parameter defines the maximum number of characters
  13                 that may be upper case in passwords.</para>
  14
  15                 <para>For example, say the password given was &quot;FRED&quot;. If <parameter moreinfo="none">
  16                 password level</parameter> is set to 1, the following combinations
  17                 would be tried if &quot;FRED&quot; failed:</para>
  18
  19                 <para>&quot;Fred&quot;, &quot;fred&quot;, &quot;fRed&quot;, &quot;frEd&quot;,&quot;freD&quot;</para>
  20
  21                 <para>If <parameter moreinfo="none">password level</parameter> was set to 2,
  22                 the following combinations would also be tried: </para>
  23
  24                 <para>&quot;FRed&quot;, &quot;FrEd&quot;, &quot;FreD&quot;, &quot;fREd&quot;, &quot;fReD&quot;, &quot;frED&quot;, ..</para>
  25
  26                 <para>And so on.</para>
  27
  28                 <para>The higher value this parameter is set to the more likely
  29                 it is that a mixed case password will be matched against a single
  30                 case password. However, you should be aware that use of this
  31                 parameter reduces security and increases the time taken to
  32                 process a new connection.</para>
  33
  34                 <para>A value of zero will cause only two attempts to be
  35                 made - the password as is and the password in all-lower case.</para>
  36
  37                 <para>Default: <command moreinfo="none">password level = 0</command></para>
  38                 <para>Example: <command moreinfo="none">password level = 4</command></para>
  39                 </listitem>
  40                 </samba:parameter>