/ 
Mail-DMARC-0.20130506
River stage one • 2 direct dependents • 3 total dependents
/ Mail::DMARC::Result::Evaluated

NAME

Mail::DMARC::Result::Evaluated - the results of applying a DMARC policy

VERSION

version 0.20130506

OVERVIEW

An evaluated DMARC result looks like the following data structure:

disposition  => 'none',   # reject, quarantine, none
dkim         => 'pass',   # pass, fail
spf          => 'pass',   # pass, fail
result       => 'pass',   # pass, fail
reason       => {
    type     => '',       # forwarded, sampled_out, trusted_forwarder,
    comment  => '',       #   mailing_list, local_policy, other
},
dkim_align   => 'strict', # strict, relaxed
spf_align    => 'strict', # strict, relaxed

The reason and comment fields are optional and may not be present.

The _align fields will only be present if the corresponding field is pass.

METHODS

disposition

When the DMARC result is not pass, disposition is the results of applying DMARC policy to a message. Generally this is the same as the header_from domains published DMARC policy. When it is not, the reason SHOULD be specified.

dkim

Whether the message passed or failed DKIM alignment. In order to pass the DMARC DKIM alignment test, a DKIM signature that matches the RFC5322.From domain must be present. An unsigned messsage, a message with an invalid signature, or signatures that don't match the RFC5322.From field are all considered failures.

dkim_align

If the message passed the DKIM alignment test, this indicates whether the alignment was strict or relaxed.

spf

Whether the message passed or failed SPF alignment.

spf_align

If the message passed the SPF alignment test, this indicates whether the alignment was strict or relaxed.

reason

If the applied policy differs from the sites published policy, the evaluated policy should contain a reason and optionally a comment.

reason => {   
    type =>  '',   
    comment => '',
},

The following reason types are defined:

forwarded
sampled_out
trusted_forwarder
mailing_list
local_policy
other

result

Whether the message passed the DMARC test. In order to pass, at least one of the defined authentication alignments must pass. At present (in 2013) the defined alignments are DKIM and SPF. Possible values are: pass, fail.

AUTHORS

  • Matt Simerson <msimerson@cpan.org>

  • Davide Migliavacca <shari@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by The Network People, Inc..

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.