NAME

Mail::SpamAssassin::Plugin::Konfidi - A SpamAssassin plugin that uses the Konfidi distributed trust network for authenticated messages.

VERSION

Version 1.0.1

SYNOPSIS

Install this module by running:

 cpan Mail::SpamAssassin::Plugin::Konfidi

Tell SpamAssassin to use it by putting the following (from this module's etc/init_konfidi.pre) in a configuration file

 loadplugin Mail::SpamAssassin::Plugin::Konfidi

Configure the plugin by putting the following (from this module's etc/61_konfidi.cf) in a configuration file (see http://wiki.apache.org/spamassassin/WhereDoLocalSettingsGo)

 ifplugin Mail::SpamAssassin::Plugin::Konfidi

 full    KONFIDI_TRUST_VALUE     eval:check_konfidi()
 describe KONFIDI_TRUST_VALUE     Konfidi-computed trust value for sender, if sender is authenticated

 endif   # Mail::SpamAssassin::Plugin::Konfidi

Set settings for yourself:

 konfidi_service_url http://test-server.konfidi.org/
 konfidi_my_pgp_fingerprint 1234DEADBEEF5678... # this should be your full 40-digit fingerprint

 konfidi_rating0_becomes_score 0
 konfidi_rating1_becomes_score -20

The rating-becomes-score settings define a linear scale, so using the above example, a Konfidi rating of 0.75 would generate a SpamAssassin score of -15. You do not set any regular 'score' rules since the scores are assigned dynamically based on these settings.

DESCRIPTION

This plugin currently only uses OpenPGP signatures for authentication and requires Mail::SpamAssassin::Plugin::OpenPGP. Future versions will also support Mail::SpamAssassin::Plugin::SPF and Mail::SpamAssassin::Plugin::DKIM for authentication.

The loadplugin statement for OpenPGP must occur before the loadplugin statement for Konfidi. This can be done by putting them in order in one file, or naming your configuration files in order like 26_openpgp.cf and 61_konfidi.cf

For project information, see http://konfidi.org

USER SETTINGS

If you want to add a header that shows the Konfidi trust value, use this:

 add_header all Konfidi-Trust-Value _KONFIDITRUSTVALUE_

AUTHOR

Dave Brondsema, <dave at brondsema.net>

BUGS

Please report any bugs or feature requests to bug-mail-spamassassin-plugin-konfidi at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Mail-SpamAssassin-Plugin-Konfidi. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Mail::SpamAssassin::Plugin::Konfidi

You can also look for information at:

* AnnoCPAN: Annotated CPAN documentation: http://annocpan.org/dist/Mail-SpamAssassin-Plugin-Konfidi
* CPAN Ratings: http://cpanratings.perl.org/d/Mail-SpamAssassin-Plugin-Konfidi
* RT: CPAN's request tracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mail-SpamAssassin-Plugin-Konfidi
* Search CPAN: http://search.cpan.org/dist/Mail-SpamAssassin-Plugin-Konfidi

COPYRIGHT & LICENSE

This program is released under the following license: Apache License, Version 2.0