Honey Pot Plugin

Use Project HoneyPot to detect and filter operations initiated from suspected spammers, search engines etc.

Public wiki sites are often plagued with spammers and other unwelcome visitors, such as search engine indexers that can suck the life out of an otherwise fast site.

Project HoneyPot has been set up to record data about IP addresses that constitute a threat to websites, either because they are an excessive drain on the resources of the sites or because they are known sources of spam.

This plugin checks incoming requests against the honeypot database and rejects operations from IP addresses found there.

The admin has full control over the operations that are checked, and the nature of the checks. Configuration is done using the http://foswiki.org/bin/configure interface.

REST handler

The plugin also publishes a REST handler that can be used to check an IP address against the database. The handler is called check and is passed the parameters ip (the IP address to check) and tests (a comma-separated list of tests to perform). If any of the tests fails, the handler will respond with a 403 (forbidden) with the name of the failing test in the response body. For example,

http://my.foswiki/rest/HoneyPotPlugin/check?ip=12.34.56.78&tests=is_search_engine,is_harvester

A description of the available tests can be found at http://search.cpan.org/dist/WWW-Honeypot-httpBL/lib/WWW/Honeypot/httpBL.pm

API

There is also an API that other plugins can use when this plugin is loaded:

Foswiki::Plugins::HoneyPotPlugin::check($domain, $tests) -> $result

• $domain - domain name or IP address to check
• $tests - either an array of predicate names or a comma-separated string list of predicates to perform e.g. 'is_comment_spammer,is_search_engine'

Installation

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Info

Author:	Foswiki:Main.CrawfordCurrie
Copyright:	© 2013, Foswiki Contributors
License:	GPL (GNU General Public License)
Release:	2013-02-13
Version:	v1.0.0
Change History:
1.0.0 (13 Feb 2013):	Initial version
Home:	http://foswiki.org/Extensions/HoneyPotPlugin
Support:	http://foswiki.org/Support/HoneyPotPlugin