mail::dkim::privatekey5.18(3) [mojave man page]

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

NAME

       Mail::DKIM::PrivateKey - a private key loaded in memory for DKIM signing

SYNOPSIS

	my $key1 = Mail::DKIM::PrivateKey->load(
		      File => "/path/to/private.key");

	my $key2 = Mail::DKIM::PrivateKey->load(
		      Data => $base64);

	# use the loaded key in a DKIM signing object
	my $dkim = Mail::DKIM::Signer->new(
		      Key => $key2,
		    );

CONSTRUCTOR

   load() - loads a private key into memory
	my $key1 = Mail::DKIM::PrivateKey->load(
		      File => "/path/to/private.key");

       Loads the Base64-encoded key from the specified file.

	 my $key2 = Mail::DKIM::PrivateKey->load(Data => $base64);

       Loads the Base64-encoded key from a string already in memory.

	 my $key3 = Mail::DKIM::PrivateKey->load(Cork => $openssl_object);

       Creates a Mail::DKIM::PrivateKey wrapper object for the given OpenSSL key object. The key object should be of type Crypt::OpenSSL::RSA.

METHODS

   cork() - access the underlying OpenSSL key object
	 $openssl_object = $key->cork;

       The returned object is of type Crypt::OpenSSL::RSA.

   sign_digest()
       Cryptographically sign the given message digest.

	 $key->sign_digest("SHA-1", sha1("my message text"));

       The first parameter is the name of the digest: one of "SHA-1", "SHA-256".

       The second parameter is the message digest as a binary string.

       The result should be the signed digest as a binary string.

AUTHOR

       Jason Long, <jlong@messiah.edu>

COPYRIGHT AND LICENSE

       Copyright (C) 2006-2008 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.18.2							    2012-11-28						 Mail::DKIM::PrivateKey(3)

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

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/15$//;

	     # use SMTP line terminators
	     $dkim->PRINT("$_1512");
	 }
	 $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.

perl v5.18.2							    2012-11-28							     Mail::DKIM(3)