Scroll to navigation

Mail::MtPolicyd::Plugin::SPF(3pm) User Contributed Perl Documentation Mail::MtPolicyd::Plugin::SPF(3pm)

NAME

Mail::MtPolicyd::Plugin::SPF - mtpolicyd plugin to apply SPF checks

VERSION

version 2.02

DESCRIPTION

This plugin applies Sender Policy Framework(SPF) checks.

Checks are implemented using the Mail::SPF perl module.

Actions based on the SPF result can be applied for:

pass (pass_mode, default: passive)
softfail (softfail_mode, default: passive)
fail (fail_mode, default: reject)

For status 'neutral' no action or score is applied.

PARAMETERS

(uc_)enabled (default: on)
Enable/disable the plugin.
(uc_)pass_mode (default: passive)
How to behave if the SPF checks passed successfully:
passive
Just apply score. Do not return an action.
accept, dunno
Will return an 'dunno' action.
pass_score (default: empty)
Score to apply when the sender has been successfully checked against SPF.
(uc_)softfail_mode (default: passive)
How to behave if the SPF checks returned a softfail status.
passive
Just apply score. Do not return an action.
accept, dunno
Will return an 'dunno' action.
reject
Return an reject action.
softfail_score (default: empty)
Score to apply when the SPF check returns an softfail status.
(uc_)fail_mode (default: reject)
reject
Return an reject action.
passive
Just apply score and do not return an action.
reject_message (default: )
If fail_mode is set to 'reject' this message is used in the reject.

The following pattern will be replaced in the string:

%LOCAL_EXPL%
Will be replaced with a (local) explanation of the check result.
%AUTH_EXPL%
Will be replaced with a URL to the explanation of the result.

This URL could be configured with 'default_authority_explanation'.

fail_score (default: empty)
Score to apply if the sender failed the SPF checks.
default_authority_explanation (default: See http://www.%{d}/why/id=%{S};ip=%{I};r=%{R})
String to return as an URL pointing to an explanation of the SPF check result.

See Mail::SPF::Server for details.

hostname (default: empty)
An hostname to show in the default_authority_explanation as generating server.
whitelist (default: '')
A comma separated list of IP addresses to skip.
check_helo (default: "on")
Set to 'off' to disable SPF check on helo.

EXAMPLE

  <Plugin spf>
    module = "SPF"
    pass_mode = passive
    pass_score = -10
    fail_mode = reject
    #fail_score = 10
  </Plugin>

SEE ALSO

Mail::SPF, OpenSPF "" in www.openspf.org, RFC 7209 <https://tools.ietf.org/html/rfc7208>

AUTHOR

Markus Benning <ich@markusbenning.de>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2014 by Markus Benning <ich@markusbenning.de>.

This is free software, licensed under:

  The GNU General Public License, Version 2, June 1991
2017-01-13 perl v5.24.1