Apache-AppSamurai - README
--------------------------

This is a system to protect vulnerable or sensitive web applications.
The target use is in reverse proxy configurations, with a Apache mod_perl
proxy inside a DMZ and a backend web server in another DMZ or an internal
network.

Apache::AppSamurai features:
* Extensible/modular multi-factor authentication
* Form based or Basic auth based authentication on frontend
* Encrypted storage of session data on proxy
* "Alterlist" system to add/change/delete cookies or headers before
  passing requests to the backend
* Able to use any Apache::Session Storage type (including MySQL or Postgress
  for clustered deployment)
* Completely configurable from httpd.conf
* Lots of other stuff

Apache 1.3.x and mod_perl 1.x are currently supported.

INSTALLATION

Module::Build is required to install this package.  (Available
from CPAN, or as a package for many systems.... and hopefully
as a default with Perl some day soon....)

To install this module, run the following commands:

    perl Build.PL
    ./Build
    ./Build test
    ./Build install

If you would like to install the example files, you can run
Build install and define an installation path for "examples":

   ./Build install --install_path examples=/usr/local/share/examples/AppSamurai

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

    perldoc Apache::AppSamurai

See example partial configurations under examples/conf/
See an example login/logout page set under examples/htdocs/

(See the note in INSTALLATION if you would like these examples installed
on you system, outside of the Apache-AppSamurai distribution directory.) 

You can also look for information at:

    AppSamurai Project Homepage:
        http://appsamurai.sourceforge.net

    AppSamurai Project Homepage (backup):
        http://www.voltagenoir.org/AppSamurai/

    Search CPAN
        http://search.cpan.org/dist/Apache-AppSamurai

    CPAN Request Tracker:
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Apache-AppSamurai

    AnnoCPAN, annotated CPAN documentation:
        http://annocpan.org/dist/Apache-AppSamurai

    CPAN Ratings:
        http://cpanratings.perl.org/d/Apache-AppSamurai

COPYRIGHT AND LICENCE

Copyright (C) 2007 Paul M. Hirsch

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

$Id: README,v 1.5 2007/07/13 21:36:17 pauldoom Exp $