Pullup ticket #2800.
[pkgsrc.git] / www / ap22-authnz-external / DESCR
1 The Apache HTTP Daemon can be configured to require users to supply logins
2 and passwords before accessing pages in some directories. Authentication is
3 the process of checking if the password given is correct for a user. Apache
4 has standard modules for authenticating out of several different kinds of
5 databases. The external authentication module provides a flexible tool for
6 creating authentication systems based on other databases.
7
8 The module can be used in either of two somewhat divergent ways:
9 1) External Authentication:
10
11 When a user supplies a login and password, mod_auth*_external runs a program
12 you write, passing it the login and password. Your program does whatever
13 checking and logging it needs to, and then returns a Accept/Reject flag to
14 Apache.
15
16 2) Hardcoded Authentication:
17
18 Some hooks have been inserted into mod_auth*_external to make it easy to
19 replace the call to the external authentication program with a call to a
20 hardcoded internal authentication routine that you write.