A Perl implementation of email authentication standards rolled up into a single easy to use milter.
This milter verifies using the following standards.
- Check HELO matches it's IP address
- DKIM (including ADSP)
Includes 3 additional modules.
- AddID - add a header to all email (example)
- ReturnOK - Checks that return addresses have properly configured MX records
- TLS (milter protocol only) - identifies TLS protected connections
Authentication Milter is able to run as a sendmail style milter, or a SMTP style after queue filter.
A very basic subset of SMTP is implemented which allows use as an after queue filter in postfix (and others)
The XFORWARD SMTP extension is supported to allow the original connection details to be passed through to the milter.
The milter does NOT store it's current email on disk, all processing is done in memory. When running in SMTP mode the milter does not issue a 250 queued response until the destination MTA has also done so.
Note: When running in SMTP mode please do not allow untrusted clients to connect to the milter directly, always filter these connections through your usual MTA first.
Limitations: SMTP protocol does not yet support detection of Authenticated connections.
Authentication Milter optionally collects and exposes metrics in a promethius compatible format.
The authentication milter metrics port it a http service which provides some basic information about the running server, and also provides a standard dashboard file for grafana.
The grafana dashboard can be imported into grafana and provides rows for all installed modules which support the metrics feature.
Point your browser at the port configured in metric_connection to access this feature.
- Works as either a milter or a SMTP filter.
- Do not reject mail during normal operation unless configured to do so.
- Add headers to allow filtering as required.
- Try to handle failures gracefully.
- Handle IPv4 and IPv6 properly
- Detect Internal/Private IP addresses and skip IP checks.
- Detect authenticated connections and skip irrelevant checks (milter mode only).
- It is assumed that this milter runs after DKIM signatures are generated, these are still validated.
- DMARC reporting should be possible.
- Modular design to allow new checks to be implemented easily.
Mailing Lists and DMARC
Mailing lists are a major source of DKIM, SPF, and DMARC failures. Legitimately modifying messages and resending with differing from addresses and from IP addresses is a legitimate use of email, however this can be a cause of false positives and result in legitimate email being quarantined or rejected.
This milter can optionally detect messages with a List-Id header, and include a flag in the resulting DMARC failure in the Authentication-Results header. This header can then be used to apply a more lenient filter.
DMARC failures with p=reject can optionally be rejected, and emails with a detected list id can be exempted from this rejection. A whitelist can be setup to excempt rejections based on IP address or valid DKIM domain.
- For Authenticated connections we only check the DKIM signature.
- For Local IPs we only check the DKIM signature.
- For Trusted IPs we only check the DKIM signature, additionally, for Trusted IPs we do not remove any Authentication headers already present.
To install the latest version released to CPAN, run the following commands:
- cpanm Mail::Milter::Authentication
From source tarball
To install this module from source, run the following commands:
- perl Makefile.PL
- make test
- make install
This module uses Dist::Zilla, you can install from a checkout using the following commands:
- cpanm Dist::Zilla
- dzil authordeps --missing|cpanm
- dzil listdeps --missing|cpanm
- dzil install
Note, installing via checkout will cause Dist::Zilla to generate a new version number each time you install based on the date of installation.
The DMARC module requires a little extra setup.
- A database needs to be created and populated
- A config file /etc/mail-dmarc.ini needs to be created
Please see the documentation for Mail::DMARC for details.
Please see the output of 'authentication_milter --help'
Credits and License
Copyright (c) 2018 Marc Bradshaw. firstname.lastname@example.org
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
See LICENSE file for license details.
Who is using this?
FastMail are using this to perform SPF/DKIM/DMARC checks on email.
Please fork and send pull requests.