NAME
   Apache::BruteWatch - Watch the Apache logs and notify of bruteforce
   password attacks

VERSION
    $Revision: 1.2 $

SYNOPSIS
   Place the following in your "httpd.conf"

       PerlLogHandler Apache::BruteWatch

       PerlSetVar BruteDatabase     DBI:mysql:brutelog
       PerlSetVar BruteDataUser     username
       PerlSetVar BruteDataPassword password

       PerlSetVar BruteMaxTries     10
       PerlSetVar BruteMaxTime      30
       PerlSetVar BruteNotify       [email protected]
       PerlSetVar BruteForgive      300

DESCRIPTION
   "mod_perl" log handler for warning you when someone is attempting a
   brute-force password attack on your web site.

Variables
   The following variables can be set in your Apache configuration file:

 BruteDatabase
   The DBI database name, such as "DBI:mysql:brutelog"

 BruteDataUser
   The database username

 BruteDataPassword
   The database password

 BruteMaxTries and BruteMaxTime
   Allow this many failed attempts in this much time. After that,
   notification will be sent. Time is in seconds.

 BruteNotify
   Email address to which notifications will be sent

 BruteForgive
   Failed login attempts will be cleaned up after they are this old. Units
   are seconds.

Database
    CREATE TABLE bruteattempt (
     ID int(11) NOT NULL auto_increment,
     ts int(11) default NULL,
     username varchar(255) default NULL,
     PRIMARY KEY  (ID)
    ) TYPE=MyISAM;

    CREATE TABLE brutenotified (
     ID int(11) NOT NULL auto_increment,
     username varchar(255) default NULL,
     ts int(11) default NULL,
     PRIMARY KEY  (ID)
    ) TYPE=MyISAM;

AUTHOR
           Rich Bowen
           [email protected]
           http://www.cre8tivegroup.com

DATE
           $Date: 2003/08/04 23:31:53 $