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

VERSION

10       version 1.20220520
11

SYNOPSIS

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

DESCRIPTION

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

SEE ALSO

56       Mail::DKIM::Signer, Mail::DKIM::Verifier
57
58       Mail::DKIM::ARC::Signer, Mail::DKIM::ARC::Verifier
59
60       http://dkimproxy.sourceforge.net/
61
62       https://github.com/fastmail/authentication_milter
63

KNOWN BUGS

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

AUTHORS

82       •   Jason Long <jason@long.name>
83
84       •   Marc Bradshaw <marc@marcbradshaw.net>
85
86       •   Bron Gondwana <brong@fastmailteam.com> (ARC)
87

CONTRIBUTORS

89       •   Aaron Thompson <dev@aaront.org>
90
91       •   Bron Gondwana <brong@fastmail.fm>
92
93       •   Christian Jaeger <ch@christianjaeger.ch>
94
95       •   Damien MASCRÉ <damienmascre@free.fr>
96
97       •   jasonlong <jasonlong@f38efd27-133c-0410-a3cc-a5f95e9cf04f>
98
99       •   José Borges Ferreira <jose.ferreira@bitsighttech.com>
100
101       •   Marc Bradshaw <marc@fastmailteam.com>
102
103       •   Martijn van de Streek <martijn@vandestreek.net>
104
105       •   Martin H. Sluka <martin@sluka.de>
106
107       •   Mohammad S Anwar <mohammad.anwar@yahoo.com>
108

THANKS

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

114       •   Copyright (C) 2013 by Messiah College
115
116       •   Copyright (C) 2010 by Jason Long
117
118       •   Copyright (C) 2017 by Standcore LLC
119
120       •   Copyright (C) 2020 by FastMail Pty Ltd
121
122       This library is free software; you can redistribute it and/or modify it
123       under the same terms as Perl itself, either Perl version 5.8.6 or, at
124       your option, any later version of Perl 5 you may have available.
125
126
127
128perl v5.36.0                      2022-07-22                     Mail::DKIM(3)
Impressum