Files
BARANTMail/DKIMVerifier.h
Brad Arant cd5e0a9905 Add real IMAP4rev1/POP3 implementations, DKIM/DMARC/SPF, SpamAssassin delivery hook
IMAP (RFC 3501): LOGIN through UID, previously all stubs except
CAPABILITY/LOGOUT/a partial APPEND. Multi-folder support with per-folder
UID/flag indexing (new MailFolder class, backed by .uidvalidity/.uidnext/
.imapindex sidecar files), ENVELOPE support (new MessageHeaders class:
header parsing, address-list parsing, IMAP quoting), and shared
cursor-based argument parsing (new IMAPArgs class: sequence sets, flag
lists, dates, folder-name normalization, and path-traversal protection
via isValidFolderName - a bare ".." folder name would otherwise resolve
into a sibling user's mailbox directory).

POP3 (RFC 1939): USER through QUIT, previously only CAPA. Added UIDL.
POP3 handlers use cursor-based parsing throughout rather than indexed
access - ZString's copy constructor doesn't copy its `list` field, and
POP3's dispatch passes the request by value, so indexed access into a
copy was silently reading nothing.

SMTP: DMARC evaluation added to the DATA-terminator path (DKIM
verification + alignment/policy, Authentication-Results header,
conditional rejection matching RFC 7489 6.3's p=reject + sampled pct=).
AUTH LOGIN now handles RFC 4954's optional inline initial response
(e.g. Python smtplib's "AUTH LOGIN <base64>" in one line) instead of
only the exact three-line form. Outbound relay now forces IPv4
(AF_INET) instead of AF_UNSPEC - this server's IPv4 has a correct PTR
record and SPF coverage, its IPv6 doesn't, and Gmail was rejecting
outbound mail with 550 5.7.25 as a result.

Delivery pipeline: local delivery now runs the message through
SpamAssassin (new SpamAssassinFilter class, speaking spamd's PROCESS
protocol directly over a raw socket - fails open/delivers unscanned if
spamd is unreachable) instead of a plain hardlink, since scanning can
tag/modify content.

BARANTMailConfig: extracted config loading into its own class.

compile: (see individual file changes - build script adjustments to
match the above).

Deliberately excluded from this commit: barantmail.log/
barantmail-service.log (operational logs, not source - barantmail.log
in particular was the runaway 55GB/12.9GB file from a busy-loop bug
fixed separately in ServerCore) and barantmail.cfg (this server's own
live deployment config, matching how APIServer's equivalent
config also stays untracked).
2026-09-03 05:24:22 +00:00

51 lines
1.8 KiB
C++

#ifndef __DKIMVerifier_h__
#define __DKIMVerifier_h__
#include <string>
#include <vector>
namespace mail {
///
/// DKIMVerifier checks the DKIM-Signature header(s) (RFC 6376) on an
/// already-fully-received message: for each one present, fetches the
/// claimed signer's public key from DNS and verifies the signature
/// against it. Exists specifically to support DMARC's DKIM-alignment
/// check (DMARCChecker) - a signature that verifies but whose d=
/// domain does not align with the message's From: header doesn't
/// make the message DMARC-authenticated via DKIM, so both the
/// cryptographic result AND the signing domain are reported back for
/// DMARC to judge alignment itself.
///
/// A message may carry more than one DKIM-Signature (e.g. one from
/// the original sender, one added by a mailing list) - every one
/// present is verified independently.
///
/// Unlike DKIMSigner (which only ever produces relaxed/relaxed,
/// rsa-sha256 signatures of its own), this has to interoperate with
/// whatever a real remote sender actually used, so it supports all
/// four canonicalization combinations (simple/relaxed for header/body)
/// a real DKIM-Signature's c= tag can specify. Does not implement
/// signature expiry (x=) checking or Ed25519 (RFC 8463) - both real
/// gaps, but the overwhelming majority of real-world DKIM signatures
/// today are plain rsa-sha256 with no expiry set.
///
class DKIMVerifier {
public:
struct SignatureResult {
bool valid = false;
std::string domain; // d= tag - the identity DMARC needs to align against
std::string selector; // s= tag
};
static std::vector<SignatureResult> verify(const std::string &message);
};
}
#endif