← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/security/passwordlevel.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

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