Welcome to WebmasterWorld Guest from

Forum Moderators: coopster & jatar k & phranque

Ban malicious visitors with this Perl Script, Part II

Follow-up script for the original "trap.pl"

9:26 am on Dec 24, 2008 (gmt 0)

WebmasterWorld Senior Member 10+ Year Member


use Fcntl qw(:DEFAULT :flock);
use Net::SMTP;

# Script Variables
my $ip = $ENV{'REMOTE_ADDR'};
my $escIP = quotemeta($ip);
my $host = $ENV{'REMOTE_HOST'};
if (defined($ip) && ((!$host) ¦¦ ($host =~ m!^\d+\.\d+\.\d+\.\d+$!))) {
if ($ip =~ m!^(\d+)\.(\d+)\.(\d+)\.(\d+)$!) {
$host = (gethostbyaddr(pack('C4',$1,$2,$3,$4),2))[0] ¦¦ $ip;
my ($rootdir) = $ENV{'DOCUMENT_ROOT'} =~ m/^([\w\.-\/\\:]+)$/;
my $domain = $ENV{'HTTP_HOST'};

# E-mail settings
my $smtp_server = "mail.example.com";
my $smtp_sender_email = "webmaster\@example.com";
my $sender_email = "webmaster\@example.com";
my $recipient_email = "webmaster\@example.com";

# Ignore List. May be any number of quoted hostnames or IP addresses separated by a comma.
# Pattern matching for REMOTE_ADDR: Left to right
# Pattern matching for REMOTE_HOST: Right to left
my @ignore_list = ("",".googlebot.com",".google.com");

# 0 == Don't send E-mail notifications
# 1 == Send E-mail notifications
my $sendmail = 1;

# 0 == Don't use filelock
# 1 == Use filelock
my $filelock = 1;

# 0 == Don't use Ignore List
# 1 == Use Ignore List
my $use_ignore_list = 1;

# Creates WHOIS link in E-mail notification
my $whois = "http://samspade.org/whois/$ip";

# Most users will not need to modify this setting outside of testing
# File in quotes should match AccessFileName in httpd.conf
my ($htaccess) = "htaccess.txt" =~ m/^([\w\.-]+)$/;

print "Status: 404 Not Found\n";
print "Content-Type: text/html\n\n";

my $serverTime = &getTime();
my $scan = grep{ $ip =~ m/^\Q$_\E/ or $host =~ m/\Q$_\E$/ } @ignore_list;
if (($use_ignore_list == 1) && ($scan > 0)) {
print "<h3>Script access ignored for $ip</h3>\n";
else {
print "<h3>Site access denied to $ip on $serverTime.</h3>\n";

sub buildHtaccess {
open HTACCESS, "$rootdir/$htaccess" or die "Can't read from $rootdir/$htaccess: $!\n";
if ($filelock == 1) {
flock HTACCESS, LOCK_SH or die "Can't share flock: $!\n";
my @list = <HTACCESS>;
close HTACCESS or die "Can't close file after read: $!\n";
my $count = grep{ $_ eq "SetEnvIf Remote_Addr \^$escIP\$ ban\n" } @list;
if ($count == 0) {
unshift(@list, "\# Host: $host\n", "SetEnvIf Remote_Addr \^$escIP\$ ban\n", "\# Banned on $serverTime\n\n");
open HTACCESS, ">$rootdir/$htaccess" or die "Can't write to $rootdir/$htaccess: $!\n";
if ($filelock == 1) {
flock HTACCESS, LOCK_EX or die "Can't set exclusive flock: $!\n";
print HTACCESS @list;
close HTACCESS or die "Can't close file after write: $!\n";
if ($sendmail == 1) {

sub sendMail {
my $smtp = Net::SMTP->new($smtp_server, Hello => $smtp_server);
$smtp->datasend("To: $recipient_email\n");
$smtp->datasend("From: $sender_email\n");
$smtp->datasend("Subject: Spider Trap Alert \@ $domain\!\n");
$smtp->datasend("X-Priority: 1 (Highest)\n\n\n");
$smtp->datasend("The following user session initiated an automated spider trap ban:\n\n");
$smtp->datasend("IP: $ip\n");
$smtp->datasend("Host: $host\n");
$smtp->datasend("Time: $serverTime\n\n");
$smtp->datasend("Whois: $whois\n\n\n");
$smtp->datasend("Additional Details:\n\n");
foreach my $key(sort keys(%ENV)) {
$smtp->datasend("$key : $ENV{$key}\n");

sub getTime {
my @months = qw(Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec);
my @weekDays = qw(Sun Mon Tue Wed Thu Fri Sat Sun);
my ($sec,$min,$hour,$mday,$mon,$yoset,$wday,$yday,$isdst) = localtime();
my $year = 1900 + $yoset;
if ($sec < 10) {
$sec = "0$sec";
if ($min < 10) {
$min = "0$min";
if ($hour < 1) {
$hour = "00";
my $time = "$weekDays[$wday], $months[$mon] $mday, $year at $hour:$min:$sec";
return $time;

Improvements Made

  • Fully detailed E-mail alerts.
  • Ignore List gives you the ability to exclude full or partial IP's and Hostnames from being banned.
  • Detailed error log reporting allows the user to quickly determine the cause of any script errors that may pop up.
  • Safer and improved .htaccess file handling.
  • Will not ban the same IP more than once.
  • Compatible with a wide range of Apache servers running on both Windows and Linux operating systems.

File Permissions

  • trap.pl, 755
  • .htaccess, 644 or 666

trap.pl File Instructions

  • Replace broken pipes with solid pipes.
  • Verify path-to-perl (line 1) is correct and modify if necessary.
  • Modify user defined variables to turn on/off features.
  • Save file in ASCII format.
  • Upload to server /cgi-bin/ and set proper file permissions.

The user defined variables are pretty self explanatory. If you are unsure of the E-mail settings, your host should be able to tell you what they need to be. More than likely, the'll be same settings you used to set up the POP3 account mail account for use with your site.

.htaccess File Instructions

For testing purposes, I suggest you first create a copy of your .htaccess file and upload it to your server as htaccess.txt. Then temporarily change $htaccess in the script above to htaccess.txt to safely test this script and work out any potential problems beforehand.

If you do not already have a similar directive within your .htaccess file, you will need to include:

SetEnvIfNoCase Request_URI \.ht(access¦passwd)$ ban

Followed by:

<Files *>
order allow,deny
allow from all
deny from env=ban

Install this code within the proper area of your .htaccess file.

Simple Spider Trap Link Instructions

I do not recommend the old method of wrapping the spider trap link around a one pixel image. Instead, I suggest they be constructed similar to:

<a href="http://www.example.com/cgi-bin/trap.cgi" rel="nofollow"></a>

It is also good practice to disallow any spider trap link in your robots.txt file.

Other Uses

I will not get into specifics because there are many examples to be found in the archives, but using mod_rewrite in conjunction with a script of this type greatly improves the webmaster's ability to control access to files on their site.

Questions, Suggestions, Comments?

Post them here and I'll try to answer them all. In the meantime, Merry Christmas and Happy Holidays. :)

[edited by: Key_Master at 9:56 am (utc) on Dec. 24, 2008]

[edited by: coopster at 1:20 pm (utc) on Dec. 26, 2008]
[edit reason] updated code upon request by Key_Master [/edit]

8:54 pm on Dec 24, 2008 (gmt 0)

5+ Year Member

Minor gripe:

I think it best to put all "use module" declarations at the beginning of the script so its easy to see what all modules are used in the script.

Besides that minor gripe it looks like a good effort and should prove useful.

3:41 am on Dec 26, 2008 (gmt 0)

WebmasterWorld Administrator phranque is a WebmasterWorld Top Contributor of All Time 10+ Year Member Top Contributors Of The Month

thanks for the updates, Key_Master!

no comments since i haven't digested your post yet but i just wanted to add a reference to your original post for "V1.0":

4:01 pm on Dec 26, 2008 (gmt 0)

5+ Year Member

Looks like my comment is no longer relevant as the module declaration has now been moved to the beginning of the code. I assume thats what one of the edits was for.
6:10 pm on Dec 26, 2008 (gmt 0)

WebmasterWorld Senior Member 10+ Year Member

Thanks coopster and krugs for your help. Yes, there were some minor updates I wanted included in my original post.

As for the old trap.pl, I wouldn't recommend anybody use that script anymore. The new script is smarter, safer, and should be easier to install and troubleshoot. Also, if your looking for a performance boost, you can run this script in mod_perl.

11:53 pm on Dec 26, 2008 (gmt 0)

5+ Year Member

More of a comment than a suggestion, the getTime sub could be replaced with a single line of code:

sub getTime {
return (sprintf "%s %02d, %s at %02d:%02d:%02d",(split(/\W+/,scalar localtime))[1,2,6,5,4,3]);

although I am pretty sure localtime returns the same format for all major operating systems, it might not. Maybe someone else knows. Of course POSIX can be used too.

7:22 am on Dec 27, 2008 (gmt 0)

WebmasterWorld Senior Member 10+ Year Member

sub getTime {
return (sprintf "%s %02d, %s at %02d:%02d:%02d",(split(/\W+/,scalar localtime))[1,2,6,5,4,3]);

I tested it on a server and I got some weird results with that code. It wouldn't display the day and it would skip ahead an hour or more with each refresh of the page.

Thanks for the input though. Keeps me thinking. :)

If you weren't concerned with losing the ability to customize the date/time format to your liking, you could delete subroutine getTime and replace line my $serverTime = &getTime(); with my $serverTime = localtime();.

[edited by: Key_Master at 8:00 am (utc) on Dec. 27, 2008]

7:08 pm on Dec 27, 2008 (gmt 0)

5+ Year Member

I tested on a Windows server and a Unix and a linux server and all worked fine. But as I was not entirely sure it would work, I should not be surprised that it doesn't. The split pattern might be better written more explicitly instead of using \W:


One final thought is that if you copied and pasted the code I posted from the forum it may have broken the code somehow. I see this forum alters posted code a little, so any code posted here would need to be checked before trying to use in a real script for syntax problems.

10:15 pm on Dec 27, 2008 (gmt 0)

WebmasterWorld Administrator coopster is a WebmasterWorld Top Contributor of All Time 10+ Year Member

Any and all references to pipe symbols are replaced by the broken pipe in the WebmasterWorld forums. You'll have to rekey those pipes.
12:14 am on Dec 28, 2008 (gmt 0)

5+ Year Member

ahh... I see in the code I posted, instead of formatting it like:


it was:


which might explain the jumping of the hour if it was expected to be first in the time stamp.

That is fixed by changing the array slice to:



Featured Threads

My Threads

Hot Threads This Week

Hot Threads This Month