NAME¶
Mail::DKIM - Signs/verifies Internet mail with DKIM/DomainKey signatures
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
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?
SEE ALSO¶
Mail::DKIM::Signer, Mail::DKIM::Verifier
http://dkimproxy.sourceforge.net/
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.
AUTHOR¶
Jason Long, <jlong@messiah.edu>
COPYRIGHT AND LICENSE¶
Copyright (C) 2006-2007, 2009 by Messiah College
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.