GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MAIL::DMARC::RESULT (3)

.ds Aq ’

NAME

Mail::DMARC::Result - an aggregate report result object

CONTENTS

VERSION

version 1.20150908

OVERVIEW

A Result object is the product of instantiating a DMARC::PurePerl object, populating the variables, and running $dmarc->validate. The results object looks like this:



    result       => pass,   # pass, fail
    disposition  => none,   # reject, quarantine, none
    reason       => [         # there can be many reasons...
            {
                type     => ,   # forwarded, sampled_out, trusted_forwarder,
                comment  => ,   #   mailing_list, local_policy, other
            },
        ],
    dkim         => pass,   # pass, fail
    dkim_align   => strict, # strict, relaxed
    spf          => pass,   # pass, fail
    spf_align    => strict, # strict, relaxed
    published    => L<Mail::DMARC::Policy>,



Reasons are optional and may not be present.

The dkim_align and spf_align fields will only be present if the corresponding test value equals pass. They are additional info not specified by the DMARC spec.

METHODS

    published

Published is a Mail::DMARC::Policy tagged with a domain. The domain attribute is the DNS domain name where the DMARC record was found. This may not be the same as the header_from domain (ex: bounces.amazon.com -vs- amazon.com).

    result

Whether the message passed the DMARC test. Possible values are: pass, fail.

In order to pass, at least one authentication alignment must pass. The 2013 draft defines two authentication methods: DKIM and SPF. The list is expected to grow.

    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. To pass SPF alignment, the RFC5321.MailFrom domain must match the RFC5322.From field.

    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 result policy should contain a reason and optionally a comment.

A DMARC result reason has two attributes, type, and comment.



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



type

The following reason types are defined and valid:



    forwarded
    sampled_out
    trusted_forwarder
    mailing_list
    local_policy
    other



comment

Comment is a free form text field.

AUTHORS

o Matt Simerson <msimerson@cpan.org>
o Davide Migliavacca <shari@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Matt Simerson.

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MAIL::DMARC::RESULT (3) 2015-09-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.