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
* Able to use any Apache::Session Storage type (including MySQL or Postgress
for clustered deployment)
* Completely configurable from httpd.conf
* Supports Apache 1.x/mod_perl 1.x and Apache 2.x/mod_perl 2.x with minimal
configuration file differences.
* Lots of other stuff
INSTALLATION
- With Module::Build (suggested)
Module::Build is suggested to install this package, and is available
from CPAN, or as a package for many systems.
(Skip to the next subsection if you prefer to use a traditional
ExtUtils::MakeMaker Makefile.PL.)
To install this module with Module::Build, run the following commands:
perl Build.PL
./Build
./Build test
./Build install
If you would like to install the tools and example files, you can run
Build install and define an installation path for "misc":
./Build install --install_path misc=/usr/local/share/AppSamurai
- With ExtUtils::MakeMaker
A simple Makefile.PL file is also provided, and should provide enough
installation functionality for most users. (Note - This method does
not install examples, tools, or detect optional modules at this time.)
To install with Makefile.PL:
perl Makefile.PL
make
make test
make install
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 page and supporting files 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) 2008 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.9 2008/04/30 21:38:52 pauldoom Exp $