Changes for version 0.35 - 2026-11-16

  • Security: three faults reported against 0.34.
  • CVE-2026-129847: a line in the header section that is not a header field (no colon; white space or nothing before the colon; a fold before the colon, which RFC 5322 does not allow and 0.34 read as a field; a first line starting with white space) was dropped unread, so it was in no header hash: such lines could be added to a signed message without breaking any Message-Instance, while other parsers read them (Python's email ends the header section at one). The Verifier now gives "PERMERROR: malformed header field" for a message with any DKIM2 field, before every other check, and the Signer refuses ("malformed header field"). A message with no DKIM2 field is still none. New HeaderParser method malformed_header. Since 0.22.
  • CVE-2026-129848: the tag-list parser trimmed a value's trailing white space with a pattern quadratic in a run of white space inside the value: a DKIM2-Signature or Message-Instance field of about 1MB took minutes, before any authentication. Linear now; what is accepted is unchanged. Since 0.20.
  • CVE-2026-129849: Mail::DKIM2::Validate::report walked the chain level by level even when the Verifier had refused it for having more than 32 Message-Instance or DKIM2-Signature fields, parsing the whole message again at every level: one request to the validator could cost minutes. Over the limit it now reports the Verifier's PERMERROR and no levels; it reads i= and m= only as chain numbers (1 to 99). Since 0.18.

Documentation

Standalone DKIM2 milter for Postfix

Modules

DKIM2 signing and verification for email
Envelope paths, domains and the From header field for DKIM2
the body hash of a message, streamed
every Message-Instance's body hash in one pass
Header canonicalization and the signing input for DKIM2
The Message-Instance and DKIM2-Signature fields of a message, numbered
Constants, chain numbering and the any/all groups shared by the DKIM2 modules
DKIM2-signed Delivery Status Notifications
SHA-2 over message content, by OpenSSL where it can
Fold a DKIM2 header field where its grammar allows
decide whether a front end may sign a message
Streaming message parser base for Signer and Verifier
every Message-Instance's header hash without undo
What a hop adds to a message's Message-Instance fields before it signs
Keys, key records, Domain Policy Records and signing algorithms for DKIM2
Compute, verify and undo Message-Instance headers
Keep message snapshots keyed by Message-Instance
The base64 JSON of a Message-Instance r= tag
verify-and-reflect DKIM2 demonstration logic for dkim2.com
One DKIM2-Signature header, parsed or under construction
Sign a message with a DKIM2-Signature header
Bcc-safe recipient grouping before DKIM2 signing
The tag=value list a DKIM2 header is made of
Small helpers shared by the Mail::DKIM2 modules
structured per-level DKIM2 and Message-Instance report
Verify the DKIM2-Signature chain on a message
wrap a single-part message in a one-part multipart/mixed
Handler class for DKIM2 signing
Handler class for DKIM2 signature verification

Provides

in lib/Mail/DKIM2/Chain.pm