mailrs-dkim 3.0.0

RFC 6376 DKIM signature verifier + signer. Parses DKIM-Signature headers, applies simple/relaxed canonicalization, verifies rsa-sha256 / ed25519-sha256 against the selector TXT record. RSA primitive backed by aws-lc-rs for ~3× faster sign vs pure-Rust. Pluggable DNS via DkimResolver trait.
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

#![doc = include_str!("../README.md")]
#![deny(missing_docs)]
#![deny(rustdoc::broken_intra_doc_links)]

//! Module layout:
//! - [`header`]    — DKIM-Signature header parser
//! - [`canon`]     — header + body canonicalization (simple / relaxed)
//! - [`headers`]   — low-level byte-region helpers (body offset, fold-aware find, b= clear)
//! - [`crypto`]    — standalone RSA-SHA256 / Ed25519-SHA256 signature verify + DNS pubkey parse
//! - [`resolver`]  — [`DkimResolver`] trait + (optional) hickory impl
//! - [`verifier`]  — full verify() entry point
//! - [`error`]     — error / temp-fail / perm-fail types

pub mod canon;
pub mod crypto;
pub mod error;
pub mod header;
pub mod headers;
pub mod resolver;
pub mod sign;
pub mod verifier;

pub use crypto::RsaSigningKey;
pub use error::{DkimError, DkimResult};
pub use header::{Algorithm, Canon, DkimHeader};
pub use resolver::DkimResolver;
pub use sign::{DkimSigningKey, SignOpts, sign};
pub use verifier::{SignatureOutput, verify, verify_all};

#[cfg(feature = "hickory")]
pub use resolver::hickory::HickoryDkimResolver;