|
1 mod_auth_form |
|
2 Apache2 Form-Based Authorization Module |
|
3 ---------------------------------------- |
|
4 |
|
5 Overview |
|
6 -------- |
|
7 |
|
8 This module is a form-based authorization module based on |
|
9 'mod_auth_mysql' and 'mod_auth_sim'. It is used to place access |
|
10 restrictions on a per-directory, per-user-request basis using |
|
11 session management. The module uses a MySQL database to retrieve |
|
12 users' group membership, maintain and validate users' sessions, |
|
13 and optionally track user activity. |
|
14 |
|
15 The mechanics of the module works in the following way. A web |
|
16 client (user) requests for a restricted page/directory. The module |
|
17 sends back a 'Page Has Moved' error, pointing the client to the page |
|
18 containing a login form. Through server-side scripting, a session is |
|
19 created in the MySQL database and the client (i.e. cookies or query |
|
20 string). The session itself consists of a unique, random, and temporary |
|
21 ID that is associated with a user. The client then makes the same |
|
22 request along with the session ID (SID) and the user ID (UID). The |
|
23 module compares and validates the two IDs against the IDs stored in the |
|
24 MySQL database. If successful, the module sends back the requested |
|
25 page; otherwise, the module once again sends back the 'Page Has Moved' |
|
26 error page. In addition (if specified), the module will also validate |
|
27 the user's group membership and act accordingly. |
|
28 |
|
29 |
|
30 Requirements |
|
31 ------------ |
|
32 - Apache2 Web Server |
|
33 -- With Runtime Library (apr0 or apr1) |
|
34 - MySQL 4.1 or greater |
|
35 - Server-Side Scripting Processor |
|
36 -- Comes with MySQLi-Capable API |
|
37 |
|
38 |
|
39 Installation |
|
40 ------------ |
|
41 Please refer to INSTALL |
|
42 |
|
43 |
|
44 Configuration |
|
45 ------------- |
|
46 Please refer to http://comp.uark.edu/~ajarthu/mod_auth_form |
|
47 |
|
48 |
|
49 Files In This Directory (Not Counting the AutoConf/AutoMake Generated Files) |
|
50 ---------------------------------------------------------------------------- |
|
51 autom4/ |
|
52 Contains various automake/autoconf support files. |
|
53 |
|
54 src/ |
|
55 Contains mod_auth_form's source code. |
|
56 |
|
57 win32/ |
|
58 Contains Visual Studio files for building under a |
|
59 Windows environment. |
|
60 |
|
61 AUTHORS |
|
62 The authors who contributed to mod_auth_form. |
|
63 |
|
64 ChangeLog |
|
65 Record of changes made to mod_auth_form. |
|
66 |
|
67 configure.in |
|
68 Input file for 'autoconf' to generate 'autom4te.cache |
|
69 and 'configure'. |
|
70 |
|
71 COPYING |
|
72 Apache2 License Agreement. |
|
73 |
|
74 Makefile.am |
|
75 Input file for 'automake' to generate 'Makefile.in'. |
|
76 |
|
77 NEWS |
|
78 User visible changes made to mod_auth_form. |
|
79 |
|
80 README |
|
81 This file. |