SpamAssassin plugin Booster

Last release: 1.0

Presentation

The idea behind the plugin is the following. You may find that most of your missed spam has low scores, but a couple of rules matches. You may think :

« I wish I could say that if at least N rules matches, the score is boosted. »

The boost then would be based on the number of rules matching and eventually balanced by a part of their individual scores.

This is what this plugin does.

It will not always be useful, or on the contrary, lead to a big amount of false-positive, depending, as usual, to the profile of your users and the kind of normal mail they received.

They might receive normal mail that commonly trigger many rules with very low individual scores, and the plugin Booster will wrongly boost the global score.

Installation

The installation is pretty simple and described in the INSTALL file provided in the archive file:

 Copy the file Booster.pm in your SpamAssassin plugin directory. On a Debian system, this is /usr/share/perl5/Mail/SpamAssassin/Plugin.

 Copy the file booster.cf in your SpamAssassin configuration directory. On a Debian system, this is /etc/spamassassin.

 In your SpamAssassin configuration file local.cf, you must enable the plugin with the following line:

use_booster 1

To disable it, either remove the line or replace 1 by 0.

Once you have installed the plugin, you probably want to tune some of the parameters below.

Configuration

The following are some parameters you can tune the plugin to your needs:

 booster_match_min: Minimum number of rules matching. Under this number, there is no boost on the score.

 booster_match_max: Maximum number of rules matching. Above this number, there is nob boost on the score. You probably already have enough mathing rules to reach the threshold.

 booster_increment: For each rule matching on the message, by how much to increment the score ?

 booster_increment_balance: For each rule matching, how we balance the increment with the value of the corresponding rule.

 booster_score_min: If the sum of balanced increments is lesser than booster_increment_min, then the Booster score contribution is booster_score_min.

 booster_score_max: If the sum of balanced increments is greater than booster_increment_max, then the Booster score contribution is booster_score_max.

 booster_ignore_zero: Do we take rules with a score of 0.0 or -0.0 into account ?

Files

Archive (tar.gz), release 1.0