← Back to branch summary

~ubuntu-branches/ubuntu/trusty/proftpd-dfsg/trusty

« back to all changes in this revision

Viewing changes to doc/modules/mod_auth.html

  • Committer: Bazaar Package Importer
  • Author(s): Francesco Paolo Lovergine
  • Date: 2011-10-06 12:57:29 UTC
  • mfrom: (1.2.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20111006125729-wiq6d3yzf2ensafj
Tags: 1.3.4~rc3-1
* New upstream pre-release.
* Refreshed all patches.
* Changed patch xferstats.holger-preiss to fix a few warnings and use
  Getopt::Std instead of the old getopts.pl which will be removed soon or
  later in perl5. Thanks lintian.
* Policy bumped to 3.9.2.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/modules/mod_auth.html
1
 
<!-- $Id: mod_auth.html,v 1.1 2011/02/20 18:16:24 castaglia Exp $ -->
 
1
<!-- $Id: mod_auth.html,v 1.2 2011/04/06 17:54:27 castaglia Exp $ -->
2
2
<!-- $Source: /cvsroot/proftp/proftpd/doc/modules/mod_auth.html,v $ -->
3
3
 
4
4
<html>
20
20
<h2>Directives</h2>
21
21
<ul>
22
22
  <li><a href="#DefaultRoot">DefaultRoot</a>
 
23
  <li><a href="#UserPassword">UserPassword</a>
23
24
</ul>
24
25
 
25
26
<hr>
37
38
 
38
39
<p>
39
40
<hr>
 
41
<h2><a name="UserPassword">UserPassword</a></h2>
 
42
<strong>Syntax:</strong> UserPassword <em>user encrypted-password</em><br>
 
43
<strong>Default:</strong> None<br>
 
44
<strong>Context:</strong> server config, <code>&lt;VirtualHost&gt;</code>, <code>&lt;Global&gt;</code>, <code>&lt;Anonymous&gt;</code><br>
 
45
<strong>Module:</strong> mod_auth<br>
 
46
<strong>Compatibility:</strong> 0.99.0pl5 and later
 
47
 
 
48
<p>
 
49
The <code>UserPassword</code> directive creates a password for a particular
 
50
<em>user</em>; this configured password will <i>override</i> the user's normal
 
51
password in <code>/etc/passwd</code> (or whichever auth module handles that
 
52
user).  <b>Note</b> that the <em>user</em> configured is a real user, and
 
53
<b>not</b> a <code>UserAlias</code>.
 
54
 
 
55
<p>
 
56
The <em>encrypted-password</em> parameter is a string which has been passed
 
57
through the standard Unix <code>crypt(3)</code> function.  <b>Do not use a
 
58
cleartext password</b>.  To obtain this <em>encrypted-password</em> value,
 
59
you can use the <a href="../utils/ftpasswd.html"><code>ftpasswd</code></a>
 
60
script's <code>--hash</code> option, <i>e.g.</i>:
 
61
<pre>
 
62
  # ftpasswd --hash
 
63
 
 
64
  Password: 
 
65
  Re-type password: 
 
66
 
 
67
  ftpasswd: $1$EsnXxyD6$tsO2YwTAT/Tl5u1NYPHIw1
 
68
</pre>
 
69
 
 
70
<p>
 
71
Example configuration:
 
72
<pre>
 
73
  # Override user bob's password with a hash version of "password"
 
74
  UserPassword bob $1$EsnXxyD6$tsO2YwTAT/Tl5u1NYPHIw1
 
75
</pre>
 
76
 
 
77
<p>
 
78
<hr>
40
79
<h2><a name="Installation">Installation</a></h2>
41
80
The <code>mod_auth</code> module is compiled by default.
42
81
 
44
83
<hr><br>
45
84
 
46
85
Author: <i>$Author: castaglia $</i><br>
47
 
Last Updated: <i>$Date: 2011/02/20 18:16:24 $</i><br>
 
86
Last Updated: <i>$Date: 2011/04/06 17:54:27 $</i><br>
48
87
 
49
88
<br><hr>
50
89