1Mail::DKIM(3)         User Contributed Perl Documentation        Mail::DKIM(3)
2
3
4

NAME

6       Mail::DKIM - Signs/verifies Internet mail with DKIM/DomainKey
7       signatures
8

SYNOPSIS

10         # verify a message
11         use Mail::DKIM::Verifier;
12
13         # create a verifier object
14         my $dkim = Mail::DKIM::Verifier->new();
15
16         # read an email from stdin, pass it into the verifier
17         while (<STDIN>)
18         {
19             # remove local line terminators
20             chomp;
21             s/\015$//;
22
23             # use SMTP line terminators
24             $dkim->PRINT("$_\015\012");
25         }
26         $dkim->CLOSE;
27
28         # what is the result of the verify?
29         my $result = $dkim->result;
30

DESCRIPTION

32       This module implements the various components of the DKIM and
33       DomainKeys message-signing and verifying standards for Internet mail.
34       It currently tries to implement these specifications:
35
36       RFC4871, for DKIM
37       RFC4870, for DomainKeys
38       draft-ietf-dmarc-arc-protocol-06, for ARC
39
40       The module uses an object-oriented interface. You use one of two
41       different classes, depending on whether you are signing or verifying a
42       message. To sign, use the Mail::DKIM::Signer class. To verify, use the
43       Mail::DKIM::Verifier class. Simple, eh?
44
45       Likewise for ARC, use the ARC modules Mail::DKIM::ARC::Signer and
46       Mail::DKIM::ARC::Verifier
47
48       If you're sending to test libraries which expect the tags in headers to
49       be sorted, you can set $Mail::DKIM::SORTTAGS to a true value, and all
50       created headers will get sorted keys
51

SEE ALSO

53       Mail::DKIM::Signer, Mail::DKIM::Verifier
54
55       Mail::DKIM::ARC::Signer, Mail::DKIM::ARC::Verifier
56
57       http://dkimproxy.sourceforge.net/
58
59       https://github.com/fastmail/authentication_milter
60

KNOWN BUGS

62       Problems passing `make test' seem to usually point at a faulty DNS
63       configuration on your machine, or something weird about your OpenSSL
64       libraries.
65
66       The "author signing policy" component is still under construction. The
67       author signing policy is supposed to identify the practice of the
68       message author, so you could for example reject a message from an
69       author who claims they always sign their messages. See
70       Mail::DKIM::Policy.
71
72       Please report bugs to the CPAN RT, or github issue tracker.
73
74       https://rt.cpan.org/Public/Dist/Display.html?Name=Mail-DKIM
75
76       https://github.com/fastmail/mail-dkim/issues
77

AUTHOR

79       Jason Long <jlong@messiah.edu>
80

CONTRIBUTORS

82       Marc Bradshaw <marc@marcbradshaw.net>, Bron Gondwana
83       <brong@fastmailteam.com>, John Levine <john.levine@standcore.com>
84

THANKS

86       Work on ensuring that this module passes the ARC test suite was
87       generously sponsored by Valimail (https://www.valimail.com/)
88

90       Copyright (C) 2006-2007, 2009 by Messiah College Copyright (C) 2017 by
91       FastMail Pty Ltd Copyright (C) 2017 by Standcore LLC
92
93       This library is free software; you can redistribute it and/or modify it
94       under the same terms as Perl itself, either Perl version 5.8.6 or, at
95       your option, any later version of Perl 5 you may have available.
96
97
98
99perl v5.30.1                      2020-01-30                     Mail::DKIM(3)
Impressum