a .NET port of the Bad Behavior PHP anti-spam and anti-email harvester library
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitattributes
.gitignore
.hgignore
.hgtags
README.md
build.py
lgpl-3.0.txt

README.md

Bad Behavior .NET

This is a .NET port of the original Bad Behavior WordPress plugin. It is built as an HTTP module, so you can just drop it into any existing website and enable it with a simple change to your web.config file.

Bad Behavior prevents spammers from ever delivering their junk, and in many cases, from ever reading your site in the first place.

Description

Welcome to a whole new way of keeping your blog, forum, guestbook, wiki or content management system free of link spam. Bad Behavior .NET is a port of the original PHP-based solution for blocking link spam and the robots which deliver it.

Thousands of sites large and small, like SourceForge, GNOME, the U.S. Department of Education, and many more, trust Bad Behavior to help reduce incoming link spam and malicious activity. This project brings the same technology to ASP.NET.

Bad Behavior .NET complements other link spam solutions by acting as a gatekeeper, preventing spammers from ever delivering their junk, and in many cases, from ever reading your site in the first place. This keeps your site's load down, makes your site logs cleaner, and can help prevent denial of service conditions caused by spammers.

Bad Behavior .NET also transcends other link spam solutions by working in completely different, unique way. Instead of merely looking at the content of potential spam, Bad Behavior analyzes the delivery method as well as the software the spammer is using. In this way, Bad Behavior can stop spam attacks even when nobody has ever seen the particular spam before.

Bad Behavior is designed to work alongside existing spam prevention services to increase their effectiveness and efficiency. Whenever possible, you should run it in combination with a more traditional spam prevention service.

Bad Behavior .NET works on virtually any ASP.NET-based Web software package, whether you use Web Forms or ASP.NET MVC. It consists of a simple HTTP module that you can just drop into your web application and configure with a couple of lines in your web.config file. Simply turn it on and stop worrying about spam!

As with the original PHP version, Bad Behavior .NET is free software released under the GNU Lesser General Public License, version 3, or at your option, any later version.

Status

Bad Behavior .NET is currently in "beta" status. Its core functionality is sufficiently complete for practical use, although further testing is still underway and some improvements are planned before the final 1.0 release.

The following parts of the API can be considered stable as of version 0.2:

  • The BadBehavior and BadBehavior.Logging namespaces
  • The BadBehavior_Log table created by the SQL Server logger
  • The configuration section in web.config
  • The name (though not the implementation details) of the SqlServerLogger class in BadBehavior.Logging.SqlServer.

This means that unless otherwise documented, no breaking changes are anticipated to public and protected members of classes and interfaces within these namespaces. On the other hand, classes and interfaces in other namespaces are subject to change at any time and you should not rely on them to remain stable in your own code.

Building

You will need the following software installed on your computer:

  • The .NET framework SDK version 4.0 or later
  • Python 2.6 or later to run the build script. Python 3.x will also work.
  • A local SQL Server 2008 Express named instance called SQLEXPRESS with a database called BadBehavior is needed to run the unit tests. The user account running the script should be granted dbo privileges to this database to create the log table.

Installation

Bad Behavior .NET can be installed using NuGet:

Install-Package BadBehavior.net -Pre

Alternatively, you can install Bad Behavior .NET manually. First copy the BadBehavior.dll file to your website's /bin directory, then add the following lines to the <system.web> section of your web.config file:

<httpHandlers>
    <add path="BadBehavior.axd" verb="GET,POST"
        type="BadBehavior.BadBehaviorHandler, BadBehavior" />
</httpHandlers>
<httpModules>
    <add name="BadBehaviorHttpModule"
        type="BadBehavior.BadBehaviorModule, BadBehavior" />
</httpModules>

Add the following lines to the <system.webServer> section of your web.config file:

<handlers>
    <add name="BadBehavior" path="BadBehavior.axd" verb="GET,POST"
        type="BadBehavior.BadBehaviorHandler, BadBehavior" />
</handlers>
<modules runAllManagedModulesForAllRequests="true">
    <add name="BadBehaviorHttpModule"
        type="BadBehavior.BadBehaviorModule, BadBehavior" />
</modules>

Note: if you already have handlers and modules defined in your web.config file, Bad Behavior should be listed first.

Contributing

Bad Behavior .NET uses Bad Behavior 2.7 as a reference. The source code for this is available from the Bad Behavior SVN repository at:

Development primarily takes place on Github. A Mercurial clone is provided as a courtesy on Bitbucket, and pull requests will be accepted there, though Github is the preferred portal for development. Bug reports and feature requests should be raised on Github in the first instance.

Before contributing a pull request, please note the following code conventions:

  1. We use four spaces for indentation, not tabs. Pull requests that mix tabs and spaces in the same file will be rejected with extreme prejudice.

  2. Keep line lengths below 100 characters where possible.

  3. Bad Behavior is intended to be deployed to the end user as a single DLL with no dependencies, so don't add extra projects to the solution and don't add third-party components, whether through NuGet or otherwise.

  4. An exception means that your method can not do what its name says that it does. Absence of an exception means that your method has done what its name says that it does. Do not deviate from these conventions.

  5. Terminology should normally match that in the original PHP Bad Behavior reference implementation. Exceptions should be noted in porting.txt.

  6. Every check-in should:

    1. make only one change
    2. have a commit summary that accurately describes that change
    3. compile without errors or warnings.