Mail::DKIM (3)

Leading comments

Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Mail::DKIM.3pm".)

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

dkimproxy.sourceforge.net

KNOWN BUGS

Problems passing `make test' seem to usually point at a faulty 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.