Black List Plugin
Your current Score for IP address 3.145.63.136:
%BLACKLIST{ action="user_score" }%
Description
This is a simple utility to keep black sheep away from a public TWiki site. The site can be protected against excessive page access (e.g. by bad robots) and suspicious activities of users, such as multiple registrations or rapid topic updates indicating
Wiki:WikiSpam.
The Plugin monitors activities by IP address and uses three IP address lists to protect the TWiki site:
- WHITELIST: Manually maintained list of users who should never get on the BANLIST
- BLACKLIST: Manually maintained list of malicious users
- BANLIST: Automatically updated list of users with suspicious activities
Users on the BLACKLIST and BANLIST will have every page access delayed by one minute and will get an error message.
To fight Wiki-spam, the Plugin can also add a
rel="nofollow"
parameter to external URLs. Search engines will not follow links that have this parameter, taking away the incentive to add spam to TWiki.
Plugin Settings
- One line description, is shown in the TextFormattingRules topic:
- Set SHORTDESCRIPTION = Utility to keep malicious users away from a public TWiki site
- WHITELIST: Comma delimited list of IP addresses; possible to use partial addresses ending in a dot
- Set DEFAULT_WHITELIST = 127.0.0.1, 134.100.10.112, 134.100.10.119, 134.100.9.77, 66.249.65., 66.249.66., 66.249.72.
- BLACKLIST: Comma delimited list of IP addresses; possible to use partial addresses ending in a dot
- Set DEFAULT_BLACKLIST = 203.88.152., 203.88.155., 219.65.75.
- BANLIST configuration, comma delimited list of:
- points for registration
- points for each save and upload
- points for view raw
- points for other actions like view
- threshold to add to BANLIST
- measured over time (in seconds)
- Set BANLISTCONFIG = 20, 5, 2, 1, 300, 300
- Your current score: %BLACKLIST{ action="user_score" }% for IP address 3.145.63.136
- Message for users on BLACKLIST and BANLIST:
- Set BLACKLISTMESSAGE = You are black listed at the Foswiki web site due to excessive access or suspicious activities. Please contact site administrator wolfgang.menzel@uni-hamburg.de if you got on the list by mistake. Black listed IP addresses will be submitted to major blacklist databases.
- Add a
rel="nofollow"
parameter to external URLs. Use this is to fight Wiki-spam. Search engines will not follow the link if a URL has a nofollow parameter, such as <a href="http://spammer.com/" rel="nofollow">
. Specify topic age in hours for which the nofollow parameter should appear (set it to a value that gives you enough time to remove spam); set it to -1 to add the nofollow parameter unconditionally to external URLs; or 0 to disable: (-1, 0, 1...N)
- Log access of users on BLACKLIST and BANLIST: (1 or 0)
Plugin Installation Instructions
Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.
- Download the ZIP file from the Plugin web (see below)
- Unzip
BlackListPlugin.zip
in your twiki installation directory. Content: File: | Description: |
data/TWiki/BlackListPlugin.txt | Plugin topic |
data/TWiki/BlackListPlugin.txt,v | Plugin topic repository |
lib/TWiki/Plugins/BlackListPlugin.pm | Plugin Perl module |
- Test if the installation was successful:
- Using above form, add the IP address of one of your workstations to the BANLIST
- Access TWiki from that workstation
- if you look at a TWiki topic (with the view script) you should see the BLACKLISTMESSAGE (defined above) after a one minute timeout
- else, you should get an 500 Internal Server Error for other scripts
- On a different workstation, remove the IP address of the test workstation from the BANLIST
Known Issues
- The BANLIST does not work until you add and remove an IP address using above form
Plugin Info
Related Topics: TWikiPreferences,
Plugins,
Google blacklist directory
--
TWiki:Main/PeterThoeny - 22 Jan 2005