huschi.net

Mail::DKIM(3)         User Contributed Perl Documentation        Mail::DKIM(3)
NAME
       Mail::DKIM - Signs/verifies Internet mail with DKIM/DomainKey
       signatures
VERSION
       version 1.20200907
SYNOPSIS
         # verify a message
         use Mail::DKIM::Verifier;
         # create a verifier object
         my $dkim = Mail::DKIM::Verifier->new();
         # read an email from stdin, pass it into the verifier
         while (<STDIN>)
         {
             # remove local line terminators
             chomp;
             s/\015$//;
             # use SMTP line terminators
             $dkim->PRINT("$_\015\012");
         }
         $dkim->CLOSE;
         # what is the result of the verify?
         my $result = $dkim->result;
DESCRIPTION
       This module implements the various components of the DKIM and
       DomainKeys message-signing and verifying standards for Internet mail.
       It currently tries to implement these specifications:
       RFC4871, for DKIM
       RFC4870, for DomainKeys
       draft-ietf-dmarc-arc-protocol-06, for ARC
       The module uses an object-oriented interface. You use one of two
       different classes, depending on whether you are signing or verifying a
       message. To sign, use the Mail::DKIM::Signer class. To verify, use the
       Mail::DKIM::Verifier class. Simple, eh?
       Likewise for ARC, use the ARC modules Mail::DKIM::ARC::Signer and
       Mail::DKIM::ARC::Verifier
       If you're sending to test libraries which expect the tags in headers to
       be sorted, you can set $Mail::DKIM::SORTTAGS to a true value, and all
       created headers will get sorted keys
SEE ALSO
       Mail::DKIM::Signer, Mail::DKIM::Verifier
       Mail::DKIM::ARC::Signer, Mail::DKIM::ARC::Verifier
       http://dkimproxy.sourceforge.net/
       https://github.com/fastmail/authentication_milter
KNOWN BUGS
       Problems passing `make test' seem to usually point at a faulty DNS
       configuration on your machine, or something weird about your OpenSSL
       libraries.
       The "author signing policy" component is still under construction. The
       author signing policy is supposed to identify the practice of the
       message author, so you could for example reject a message from an
       author who claims they always sign their messages. See
       Mail::DKIM::Policy.
       Please report bugs to the CPAN RT, or github issue tracker.
       https://rt.cpan.org/Public/Dist/Display.html?Name=Mail-DKIM
       https://github.com/fastmail/mail-dkim/issues
AUTHORS
       o   Jason Long <jason AT long.name>
       o   Marc Bradshaw <marc AT marcbradshaw.net>
       o   Bron Gondwana <brong AT fastmailteam.com> (ARC)
CONTRIBUTORS
       o   Aaron Thompson <dev AT aaront.org>
       o   Bron Gondwana <brong AT fastmail.fm>
       o   Christian Jaeger <ch AT christianjaeger.ch>
       o   Damien MASCRE <damienmascre AT free.fr>
       o   jasonlong <jasonlong@f38efd27-133c-0410-a3cc-a5f95e9cf04f>
       o   Jose Borges Ferreira <jose.ferreira AT bitsighttech.com>
       o   Martijn van de Streek <martijn AT vandestreek.net>
       o   Martin H. Sluka <martin AT sluka.de>
       o   Mohammad S Anwar <mohammad.anwar AT yahoo.com>
THANKS
       Work on ensuring that this module passes the ARC test suite was
       generously sponsored by Valimail (https://www.valimail.com/)
COPYRIGHT AND LICENSE
       o   Copyright (C) 2013 by Messiah College
       o   Copyright (C) 2010 by Jason Long
       o   Copyright (C) 2017 by Standcore LLC
       o   Copyright (C) 2020 by FastMail Pty Ltd
       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself, either Perl version 5.8.6 or, at
       your option, any later version of Perl 5 you may have available.
perl v5.26.3                      2020-09-07                     Mail::DKIM(3)