mod_auth_form
Apache2 Form-Based Authorization Module

Overview

This module is a form-based authorization module based on 'mod_auth_mysql' and 'mod_auth_sim'. It is used to place access restrictions on a per-directory, per-user-request basis using session management. The module uses a MySQL database to retrieve users' group membership, maintain and validate users' sessions, and optionally track user activity.

The mechanics of the module works in the following way. A web client (user) requests for a restricted page/directory. The module sends back a 'Page Has Moved' error, pointing the client to the page containing a login form. Through server-side scripting, a session is created in the MySQL database and the client (i.e. cookies or query string). The session itself consists of a unique, random, and temporary ID that is associated with a user. The client then makes the same request along with the session ID (SID) and the user ID (UID). The module compares and validates the two IDs against the IDs stored in the MySQL database. If successful, the module sends back the requested page; otherwise, the module once again sends back the 'Page Has Moved' error page. In addition (if specified), the module will also validate the user's group membership and act accordingly.

Requirements

Apache2 Web Server -- With Runtime Library (apr0 or apr1)
MySQL 4.1 or greater
Server-Side Scripting Processor -- Comes with MySQLi-Capable API

Installation

Please refer to INSTALL

Configuration

Please refer to http://comp.uark.edu/~ajarthu/mod_auth_form

Files In This Directory (Not Counting the AutoConf/AutoMake Generated Files)

autom4/

Contains various automake/autoconf support files.

src/

Contains mod_auth_form's source code.

win32/

        Contains Visual Studio files for building under a
        Windows environment.

AUTHORS

The authors who contributed to mod_auth_form.

ChangeLog

Record of changes made to mod_auth_form.

configure.in

        Input file for 'autoconf' to generate 'autom4te.cache
        and 'configure'.

COPYING

Apache2 License Agreement.

Makefile.am

Input file for 'automake' to generate 'Makefile.in'.

NEWS

User visible changes made to mod_auth_form.

README

This file.