/ 
Mail-DKIM2-0.10

Changes for version 0.10 - 2026-10-02

  • API cleanup ahead of a CPAN release. Incompatible changes are marked *.
  • New top-level Mail::DKIM2 module documenting the conventions every module follows; every module now carries the distribution $VERSION.
  • Constructor options are CamelCase and validated: an unknown option croaks. Verifier options (SkipTimestampCheck, AllowUnsignedMI, MidProcess, HeadersOnly, PubkeyCallback, Resolver, IgnorePrefixes) can be given to new() and are no longer silently discarded.
  • load($input): one-shot PRINT+CLOSE taking a string, scalar ref, filehandle or Email::MIME, normalising LF to CRLF. TIEHANDLE lets a Signer or Verifier be tied to a filehandle.
  • Verifier->signatures and ->top_signature for Authentication-Results writers.
  • Ignore prefixes are per instance: Common::ignore_header_prefixes is gone; pass IgnorePrefixes to Verifier->new and to MessageInstance->calculate/verify/chain_verifies instead. should_skip takes the prefixes as a second argument.
  • Key fetching moves to the Verifier: Signature->fetch_public_key is replaced by Verifier->fetch_public_key($signature, $idx), driven by the Resolver option. Only NXDOMAIN/NOERROR/NODATA are permanent; any other resolver error is temperror. The pubkey callback receives the verifier as a third argument.
  • Signer no longer dies from inside PRINT on a chain it cannot extend: result() is 'fail' and details() says why. result() is undef (not '?') before CLOSE. details() and result_detail() added.
  • Signature: mail_from(), rcpt_to() and flags() are get/set like the other tag accessors; set_rcpt_to is removed.
  • Mail::DKIM2::DSN methods take CamelCase named arguments (Message, Signer, To, ReportingMTA, Status, Reason, PubkeyCallback, ForwarderDomain, SkipAuthentication, SkipTimestampCheck) instead of a hashref. Validate::report takes PubkeyCallback, DnsPath, SkipTimestampCheck.
  • Command-line tools: dkim2sign (was dkim2sign.pl) and the new dkim2verify are installed; verify-sig.pl, calculate-dkim2.pl and the *-mailversion tools are removed.
  • POD rewritten for spec-06 (the previous text described draft-clayton-08 tags); Net::DNS declared as a prerequisite.
  • dkim2-milter and dkim2-split-lmtp are installed programs (were bin/*.pl, run from the checkout). X-DKIM2-Info sw= says dkim2-milter.

Documentation

dkim2-milter
Standalone DKIM2 milter for Postfix

Modules

Mail::DKIM2
DKIM2 signing and verification for email
Mail::DKIM2::Common
Canonicalization, hashing, folding and key handling for DKIM2
Mail::DKIM2::DSN
DKIM2-signed Delivery Status Notifications
Mail::DKIM2::HeaderParser
Streaming message parser base for Signer and Verifier
Mail::DKIM2::MessageInstance
Compute, verify and undo Message-Instance headers
Mail::DKIM2::MessageStore
Keep message snapshots keyed by Message-Instance
Mail::DKIM2::Reflector
verify-and-reflect DKIM2 demonstration logic for dkim2.com
Mail::DKIM2::Signature
One DKIM2-Signature header, parsed or under construction
Mail::DKIM2::Signer
Sign a message with a DKIM2-Signature header
Mail::DKIM2::Split
Bcc-safe recipient grouping before DKIM2 signing
Mail::DKIM2::TagValueList
The tag=value list a DKIM2 header is made of
Mail::DKIM2::Validate
structured per-level DKIM2 and Message-Instance report
Mail::DKIM2::Verifier
Verify the DKIM2-Signature chain on a message
Mail::Milter::Authentication::Handler::DKIM2Sign
Handler class for DKIM2 signing
Mail::Milter::Authentication::Handler::DKIM2Verify
Handler class for DKIM2 signature verification

Examples

Other files