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 \s-1DKIM\s0 and DomainKeys message-signing and verifying standards for Internet mail. It currently tries to implement these specifications:

\s-1RFC4871\s0, for \s-1DKIM\s0
\s-1RFC4870\s0, 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?

RELATED TO Mail::DKIM…

Mail::DKIM::Signer, Mail::DKIM::Verifier

http://dkimproxy.sourceforge.net/

KNOWN BUGS

Problems passing `make test' seem to usually point at a faulty \s-1DNS\s0 configuration on your machine, or something weird about your OpenSSL libraries.

The \*(L"author signing policy\*(R" 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, <[email protected]>

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.