stopforumspam 1.1

Django middleware for blocking IPs listed in stopforumspam.com

A django application that provides middleware for blocking IPs listed in stopforumspam.com’s database.

A management command is provided for updating the database:

manage.py sfsupdate [–force]

…and all IPs are stored in Django models so you can add your own as well (remember to mark them permanent so they don’t get deleted!)

Installation

At the moment there is no updated packages, so install directly from github using:

pip install git+git://github.com/benjaoming/django-stopforumspam.git

The old release was installed by running:

sudo pip install stopforumspam

Add this to settings.MIDDLEWARE_CLASSES

‘stopforumspam.middleware.StopForumSpamMiddleware’

Then add this to INSTALLED_APPS

‘stopforumspam’

And run

./manage.py syncdb

To insert all the IPs run this command, which you should make a cronjob (run it every 24h).

./manage.py sfsupdate

You may remove stopforumspam from your INSTALLED_APPS after, if you do not wish to see it in your admin pages.

Configuration

The following options exist for your project’s settings.py file:

To check ALL POST requests:

SFS_ALL_POST_REQUESTS = True

To ignore some URLS:

SFS_URLS_IGNORE = [“url_name”, “/url/path”]

To only include some URLS (only works if SFS_ALL_POST_REQUEST=False):

SFS_URLS_INCLUDE = [“url_name”, “/url/path”]

To configure where to download the file from (you can MAX download 2 times a day) - see http://www.stopforumspam.com for more resources:

SFS_SOURCE_ZIP = “http://www.stopforumspam.com/downloads/listed_ip_7.zip”

Remember to configure this as well – it’s the name of the file inside the .zip file:

SFS_ZIP_FILENAME = “listed_ip_7.txt”

For testing you can force all requests to be checked.

SFS_FORCE_ALL_REQUESTS = True

Cron Jobs

You probably want to automatically update the list of blocked IP addresses every 24 hours or 48 hours. To do that, you can insert a line in crontab.

0 2 * * * cd /your/project/path/ && python manage.py sfsupdate

The above would update at 2 AM every night.