Mail::DKIM

Mail::DKIM(3)	     User Contributed Perl Documentation	Mail::DKIM(3)



NAME
       Mail::DKIM - Signs/verifies Internet mail with DKIM/DomainKey signa-
       tures

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 dif-
       ferent 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 mes-
       sage 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.



perl v5.8.8			  2009-05-22			Mail::DKIM(3)