trusty (3) Mail::DKIM.3pm.gz

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.