mailrs-shield 1.0.2

SMTP anti-spam primitives: DNS blocklist (DNSBL) queries, greylisting policy with optional Redis store, and PTR / forward-confirmed reverse DNS (FCrDNS) checks.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

#![deny(missing_docs)]
#![deny(rustdoc::broken_intra_doc_links)]

//! SMTP anti-spam primitives: DNSBL, greylisting, and FCrDNS.
//!
//! Three independent modules used by inbound SMTP pipelines to filter
//! unwanted mail at connect / sender-evaluation time:
//!
//! - [`dnsbl`] — query DNS-based blocklists (Spamhaus, Barracuda, …)
//!   for an inbound client IP, with an in-process TTL cache.
//! - [`greylist`] — temporary 4xx-defer policy ([Harris 2003] / RFC
//!   6647): unknown sender triplets get one initial defer; legitimate
//!   senders retry, spammers don't. Comes with an optional Redis-backed
//!   store ([`greylist::GreylistDb`]) behind the default `redis-store`
//!   feature.
//! - [`ptr`] — forward-confirmed reverse DNS (FCrDNS) score for an
//!   inbound client: 0.0 if PTR → forward roundtrip matches the EHLO
//!   domain, 1.0 if it doesn't.
//!
//! ## Feature flags
//!
//! - `redis-store` (default) — enables the Redis-backed
//!   [`greylist::GreylistDb`] store (with optional Postgres cold backup).
//!   Disable to plug in your own store.
//!
//! [Harris 2003]: https://projects.puremagic.com/greylisting/

/// DNSBL reverse-IP scoring helpers (Spamhaus + generic lookup interpretation).
pub mod dnsbl;
/// RFC 5321-style greylisting: defer-on-first-seen with optional Postgres + Valkey storage.
pub mod greylist;
/// Forward-confirmed reverse DNS scoring (FCrDNS) for sender-IP reputation.
pub mod ptr;