Copyright (c) 2003 Alex Pleiner - zeitform Internet Dienste.
[email protected] - http://www.zeitform.de. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.


--------
Abstract
--------

Apache::AntiSpam::SpamTrap is a subclass of Apache::AntiSpam, filter
module to prevent e-mail addresses exposed as is on web pages. This
module adds a Blowfish encrypted string suffix to the local-part of
e-mail addresses. This string contains a timestamp and the IP address
of the remote host. This enables you to identify a spammer's address
harvester by its IP address and take steps to prosecute him.

The encryption prevents faking and may help in a prosecuting attemp.

For example, <[email protected]> will be filtered to
<[email protected]>.

This module is Filter aware, meaning that it can work within
Apache::Filter framework without modification.

This work is based on the Apache::AntiSpam::* modules provided by
Tatsuhiko Miyagawa <[email protected]>. The idea is taken from
Daniel A. Rehbein (http://daniel.rehbein.net/).

------------
Requirements
------------

This module requires:

  - Apache::AntiSpam
  - Crypt::Blowfish

The requirements are encoded in Makefile.PL.

------------------
Basic Installation
------------------

Apache::AntiSpam::SpamTrap may be installed through the CPAN shell in
the usual CPAN shell manner.  This typically is:

 $ perl -MCPAN -e 'install Apache::AntiSpam::SpamTrap'

You can also read this README from the CPAN shell:

 $ perl -MCPAN -e shell
 cpan> readme Apache::AntiSpam::SpamTrap

And you can install the component from the CPAN prompt as well:

 cpan> install Apache::AntiSpam::SpamTrap

-------------------
Manual Installation
-------------------

Apache::AntiSpam::SpamTrap can also be installed manually.

Download the package from:
http://alex.zeitform.de/spamtrap/

Downloading and unpacking the distribution are left as exercises for
the reader.  To build and test it:

 perl Makefile.PL
 make test

When you're ready to install the component:

 make install

It should now be ready to use.