Mail::DKIM(3pm) User Contributed Perl Documentation Mail::DKIM(3pm)
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
• Jason Long <jason@long.name>
• Marc Bradshaw <marc@marcbradshaw.net>
• Bron Gondwana <brong@fastmailteam.com> (ARC)
CONTRIBUTORS
• Aaron Thompson <dev@aaront.org>
• Bron Gondwana <brong@fastmail.fm>
• Christian Jaeger <ch@christianjaeger.ch>
• Damien MASCRÉ <damienmascre@free.fr>
• jasonlong <jasonlong@f38efd27-133c-0410-a3cc-a5f95e9cf04f>
• José Borges Ferreira <jose.ferreira@bitsighttech.com>
• Martijn van de Streek <martijn@vandestreek.net>
• Martin H. Sluka <martin@sluka.de>
• Mohammad S Anwar <mohammad.anwar@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
• Copyright (C) 2013 by Messiah College
• Copyright (C) 2010 by Jason Long
• Copyright (C) 2017 by Standcore LLC
• 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.30.3 2020-09-11 Mail::DKIM(3pm)
Generated by dwww version 1.14 on Fri Jan 24 06:33:09 CET 2025.