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
39       The module uses an object-oriented interface. You use one of two
40       different classes, depending on whether you are signing or verifying a
41       message. To sign, use the Mail::DKIM::Signer class. To verify, use the
42       Mail::DKIM::Verifier class. Simple, eh?
43

SEE ALSO

45       Mail::DKIM::Signer, Mail::DKIM::Verifier
46
47       http://dkimproxy.sourceforge.net/
48

KNOWN BUGS

50       Problems passing `make test' seem to usually point at a faulty DNS
51       configuration on your machine, or something weird about your OpenSSL
52       libraries.
53
54       The "author signing policy" component is still under construction. The
55       author signing policy is supposed to identify the practice of the
56       message author, so you could for example reject a message from an
57       author who claims they always sign their messages. See
58       Mail::DKIM::Policy.
59

AUTHOR

61       Jason Long, <jlong@messiah.edu>
62

64       Copyright (C) 2006-2007, 2009 by Messiah College
65
66       This library is free software; you can redistribute it and/or modify it
67       under the same terms as Perl itself, either Perl version 5.8.6 or, at
68       your option, any later version of Perl 5 you may have available.
69
70
71
72perl v5.12.2                      2010-11-14                     Mail::DKIM(3)
Impressum