Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Mail::DMARC::Report::RUservContributed Perl DocMail::DMARC::Report::Receive(3)

NAME
       Mail::DMARC::Report::Receive - process incoming DMARC reports

VERSION
       version 1.20190308

DESCRIPTION
       Receive DMARC reports and save them to the report store/database.

METHODS
   from_imap, from_file, from_mbox
       These methods are called	by dmarc_receive program, which	has its	own
       documentation and usage instructions. The methods accept	a message (or
       list of messages) and create an Email::Simple object from each, passing
       that object to from_email_simple.

   from_email_simple
       Accepts an Email::Simple	message	object.	Returns	the type of DMARC
       report detected or undef	if no DMARC report was detected.

       When forensic reports are detected, no further processing is done.

       When an aggregate report	is detected, the report	details	are extracted
       from the	message	body as	well as	the Subject field/header and
       attachment metadata.

       Parsing of the Subject and MIME metadata	is necessary because the 2013
       draft DMARC specification does not REQUIRE the envelope_to domain name
       to be included in the XML report. For example, the only way to know
       that the	email which generated this particular report was sent to
       hotmail.com is to extract the envelope_to domain	from the message
       metadata	(Org Name=Microsoft, hotmail.com is not	in the XML). So	far,
       every messsage I	have seen has had the envelope_to domain in one
       location	or the other.

       To extract messages from	the message body, the MIME attachments are
       decompressed and	passed to handle_body.

   handle_body
       Accepts a XML message, parsing it with XML::LibXML and XPath
       expressions. The	parsed data is stored in a Mail::DMARC::Report object.
       When the	parsing	is complete, the report	object is saved	to the report
       store.

AUTHORS
       o   Matt	Simerson <msimerson@cpan.org>

       o   Davide Migliavacca <shari@cpan.org>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2018 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.

perl v5.32.1			  2019-03-08   Mail::DMARC::Report::Receive(3)

NAME | VERSION | DESCRIPTION | METHODS | AUTHORS | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Mail::DMARC::Report::Receive&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help