Fix download location.
[jelmer/pam-krb5-migrate.git] / README
1 pam_krb5_migrate is a stackable authentication module that takes a username
2 and password from an earlier module in the stack, and attempts to
3 transparently add them to a Kerberos realm using the Kerberos 5 kadmin
4 service.
5 The module can be used to ease the administrative burdens of migrating a
6 large installed userbase from pre-existing authentication methods to a
7 Kerberos-based setup.
8
9 The most current version of this module can always be found at
10 http://samba.org/~jelmer/pam_krb5_migrate
11
12 For sample usage in a module stack, see the enclosed login.pam file.
13
14 The following options are recognized by the module:
15
16 debug                 turn debug logging on
17 keytab=<file>         use alternate keytab for authentication
18                          (default is /etc/security/pam_krb5.keytab)
19 min_uid=<uid>         don't add principals for uid's lower than <uid>.
20                          (default is 100)
21 principal=<name>      use the key for <name> instead of the default
22                          pam_migrate/<hostname> key
23 realm=<REALM>         update the database for a realm other than the
24                          default realm.
25
26 pam_krb5_migrate was written by Steve Langasek <vorlon@netexpress.net>.
27
28 Please send questions and comments (and especially bugfixes) to the current 
29 maintainer, Jelmer Vernooij <jelmer@samba.org>.
30