Authentication Manager
======================

About
Authentication Manager is a simple administration frontend to
a authentication database for use with mod_auth_mysql and
.htaccess to protect directories on your webserver.

Currently, Authentication Manager is available in English
and German. Further translations can easily put in the lang
folder. Don't forget to adjust the available languages variable
in the config file.

License
Authentication Manager, a web interface to mod_auth_mysql
Copyright (C) 2005 Andreas Oertle

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA  02110-1301, USA.

Requirements
 - Apache
 - MySQL
 - PHP 4 or higher (Software has been developed under PHP 5)
 - mod_auth_mysql <http://modauthmysql.sourceforge.net/>
 
Installation Steps

1. Install & configure Apache with mod_auth_mysql & PHP
2. unpack the tarball to the desired directory.
   i.e. `tar -xzf auth-manager-x.x.tar.gz` or
        `tar -xjf auth-manager-x.x.tar.bz2`
3. import authdb.sql (which is in the docs directory) into
   your database.
   `mysql -u USERNAME -p DATABASE < authdb.sql`
4. edit the file includes/config.inc.php to reflect your
   settings.
5. now go to the admin backend:

   http://your.website.org/auth/admin/

   a) create an admin user

   b) add the admin user to the group 'basic'
   
   c) create a .htaccess with the group 'basic' and a
      meaningful name for the description, i.e.
      'auth manager'

   d) now create the file .htaccess with the content
      of the box and save that in the 'auth' directory.

   e) add the admin user to the group 'authadmin'

   f) create a .htaccess with the group 'authadmin' and a
      meaningful name for the description, i.e.
      'auth manager admin backend'

   g) now create the file .htaccess with the content
      of the box and save that in the 'auth/admin'
      directory.

6. delete the directory docs/. you don't need that anymore.

7. you're done!
   add the users and groups you want, generate the .htaccess
   file and copy that into the directory you wish to protect.

Bugs
No known bugs. If you've found one, please contact the authors!

Authors
init0.ch, Andreas Oertle <a+authentication-manager@init0.ch>