Mail::DKIM::PrivateKey(3pm)

Mail::DKIM::PrivateKey3pm

A private key loaded in memory for dkim signing

Usage

 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,
             );

Version

version 1.20240923

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.

1;

Thanks

Work on ensuring that this module passes the ARC test suite was generously sponsored by Valimail (https://www.valimail.com/)

Releases

10 releases since Debian 5.0 (Lenny); the text changed 8 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8–9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch