summaryrefslogtreecommitdiffstats
path: root/mail/courier-authlib/DETAILS
blob: e67f1de5c981372eece7d31f61ef1e9f61645fe7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
           SPELL=courier-authlib
         VERSION=0.66.3
          SOURCE=${SPELL}-${VERSION}.tar.bz2
         SOURCE2=${SOURCE}.sig
  SOURCE2_IGNORE=signature
SOURCE_DIRECTORY=${BUILD_DIRECTORY}/${SPELL}-${VERSION}
   SOURCE_URL[0]=http://downloads.sourceforge.net/project/courier/authlib/${VERSION}/${SOURCE}
  SOURCE2_URL[0]=http://downloads.sourceforge.net/project/courier/authlib/${VERSION}/${SOURCE2}
      SOURCE_GPG="courier.gpg:${SOURCE2}"
        WEB_SITE=http://www.courier-mta.org/authlib/
         ENTERED=20050313
      LICENSE[0]=GPL
        KEYWORDS="mail"
           SHORT="Provides authentication services for other Courier applications."
cat << EOF

The Courier authentication library provides authentication services for other
Courier applications. In this context, the term "authentication" refers to
the following functions:

  1) Take a userid or a loginid, and a password. Determine whether the
     loginid and the password are valid.
  2) Given a userid, obtain the following information about the userid:
     A) The account's home directory.
     B) The numeric system userid and groupid that owns all files associated
        with this account.
     C) The location of the account's maildir.
     D) Any maildir quota defined for this account. (See the Courier
        documentation for more information on maildir quotas.)
     E) Other miscellaneous account-specific options.
  3) Change the password associated with a loginid.
  4) Obtain a complete list of all loginids.

The Courier authentication library provides alternative implementations of
these authentication services:

  1) Use the traditional system password files: /etc/passwd and /etc/shadow,
     possibly in conjunction with the PAM library.
  2) Maintain all this information in a GDBM or a DB database. The GDBM or
     the DB database is compiled from plain text files. Perl scripts provide
     a simple interface for creating and editing the authentication
     information, then a script compiles the plain text files into a
     database.
  3) Use an LDAP server for authentication.
  4) Use a table in a MySQL database for authentication.
  5) Use a table in a PostgreSQL database for authentication.

All Courier components that use this authentication library, therefore, will
be able to authenticate E-mail accounts using any of the above methods.

EOF