Mail::DKIM.3pm

Langue: en

Autres versions - même langue

Version: 2010-01-23 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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 (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.