39. pepsi-stage-dkim-sign¶
Stellt DKIM-Signaturen vor der Zustellung voran.
39.1. Rolle¶
pepsi-stage-dkim-sign signiert die Nachricht per DKIM und schaltet sie zu einer Zustell-Stage weiter. Die Trennung von Signieren und Nachrichtenkonstruktion lässt pepsi-stage-bounce eine unsignierte DSN bauen und ihr NEXT_STAGE hierher richten, sodass ein erzeugter Bounce vor dem Senden signiert wird. Referenz: pepsi-stage-dkim-sign(1).
39.2. Funktionen¶
DKIM mit doppelter Signatur (RFC 6376): stellt standardmäßig sowohl einen RSA-2048- als auch einen Ed25519-
DKIM-Signature-Header (RFC 8463) voran;[pepsi] DKIM_ALGORITHMSschränkt das auf einen ein (die größten Empfänger verifizieren Ed25519 nicht und melden es in DMARC-Aggregatberichten alsfail).Signierdomain-Auswahl:
SIGNING_DOMAIN, falls gesetzt, sonst die Domain desFrom:-Headers der Nachricht.Immer vollständige Abdeckung des Nachrichtentexts: Das
l=-Tag für die Länge des Nachrichtentexts aus RFC 6376 wird nie ausgegeben und lässt sich nicht konfigurieren. Strenge Verifizierer (mail-auth, Stalwart und Pepsis eigener) weisen eine Signatur mitl > 0rundheraus zurück, und RFC 6376 §8.2 warnt, dass angehängter Inhalt das Original in den Augen des Lesers ersetzen kann.Nur-Voranstellen / einzelner Schreibvorgang: Signaturen werden oben hinzugefügt, sodass bestehende Signaturen weiter unten in der Nachricht unberührt bleiben; nur die
headers-Spalte wird umgeschrieben, sofern der Nachrichtentext nicht konvertiert wurde (nächster Punkt).7-Bit vor dem Signieren (RFC 6376 Abschnitt 5.3): Ein 8-Bit-Nachrichtentext wird vor der Berechnung der Signatur als quoted-printable oder base64 neu kodiert, sodass ein nächster Hop ohne
8BITMIMEdas Relay nicht zwingt, ihn danach neu zu kodieren und die Signatur zu brechen. Nicht getan, wenn bereits eine andere Signatur die 8-Bit-Bytes abdeckt (eineDKIM-SignatureoderARC-Message-Signaturean der Nachricht, einmultipart/signed-Teil), und auch nicht, wenn die Header der NachrichtSMTPUTF8brauchen.Keine Signatur für eine Fälschung unserer Domain: Eine Nachricht wird unsigniert weitergeschaltet, wenn sie von außen kam, ihr
From:mit der signierenden Domain ausgerichtet ist und der Ingress sie weder per DMARC noch per ausgerichteter DKIM-Signatur authentifiziert hat. So lässt ihre Weiterleitung sie beim nächsten Hop nicht DMARC bestehen. Hier eingelieferte Mail und von Pepsi verfasste Mail (DSNs, Benachrichtigungen, Listenkopien) werden wie üblich signiert. MitSIGNING_DOMAINwird auch von außen empfangene Mail unsigniert weitergeschaltet, derenFrom:nicht zur Organisation dieser Domain gehört (weitergeleitete Mail eines fremden Autors). Die SPF-Hälfte dieser Regel deckt die dedizierte SRS-Domain von pepsi-stage-srs ab; siehe Weitergeleitete Fälschungen unserer eigenen Domain (Ein entfernter Absender).Striktes Lesen von ``From:``: Die signierende Domain wird einem
From:nur entnommen, wenn sich jede Mailbox darin strikt parsen lässt (CERT/CC VU#517845), sodass ein Feld, das Clients zu verschiedenen Adressen auflösen, nie als die Domain signiert wird, die ein nachsichtiger Leser wählen würde.Fail-closed: Abgesehen von dieser Regel wird eine Nachricht nie unsigniert weitergeschaltet. Eine Nachricht lässt sich nicht signieren, wenn sich keine signierende Domain bestimmen lässt (kein
SIGNING_DOMAINund keinFrom:, das sich nur auf eine Weise lesen lässt), wenn pepsi-dkim(1) nicht für diese Domain signiert oder wenn dasFrom:einer hier eingelieferten oder verfassten Nachricht nicht zur Organisation eines konfiguriertenSIGNING_DOMAINgehört. Eine solche Nachricht wird in einen Datensatz pro Empfänger aufgeteilt und mit einem DSN-Grund (5.6.0oder5.7.1) zumBOUNCE_STAGEder Stage umgeleitet. OhneBOUNCE_STAGEoder bei einer Nachricht mit Null-Absender schlägt sie fehl (terminalesfailed, mit dem Grund instate.last_error), und pepsi-failure-bouncer oder der Betreiber entscheidet, was mit ihr geschieht. Ist der Signier-Daemon nicht erreichbar oder lehnt er aus einem anderen Grund ab, ist der Host schuld: Die Nachricht wird pausiert und erneut versucht, mit dem Grund instate.last_error, bis zumMAX_LIFETIMEder Stage (Standardwert 120 Stunden). Starten Siepepsi-dkim.service, und die Warteschlange leert sich von selbst.
39.3. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-dkim-sign, NEXT_STAGE (erforderlich) und SIGNING_DOMAIN, dazu die Signaturparameter HEADER_CANONICALIZATION / BODY_CANONICALIZATION (relaxed, der Standard, oder simple, unabhängig voneinander wählbar), SIGNED_HEADERS (die h=-Menge; muss From enthalten; der Standard deckt List-Unsubscribe und List-Unsubscribe-Post ab, wie RFC 8058 verlangt, und übersigniert jedes genannte Feld, sodass ein vorangestelltes zweites To: oder Reply-To: die Signatur bricht) und SIGNATURE_EXPIRATION_DAYS (das x=-Tag, standardmäßig sieben Tage nach dem Signieren; 0 gibt keines aus, siehe Die Lebensdauer unserer DKIM-Signaturen). [pepsi] DKIM_ALGORITHMS entscheidet, welche Signaturen erstellt werden. Siehe pepsi-stage-dkim-sign(1).
Die Stage hält keinen Schlüssel: pepsi-dkim(1) tut das, unter einem eigenen Konto, und signiert den Header-Block, den die Stage baut und an seinen Socket sendet. Die Selektoren sind die des Daemons (<DKIM_SELECTOR>-YYYYMM und dasselbe mit -ed25519) und ändern sich, wenn er rotiert. Eine kompromittierte Stage kann daher keinen Schlüssel kopieren, aber sie kann, solange sie läuft, weiterhin Mail einer bedienten Domain über den Socket signieren lassen, daher ist eine Signatur nur so stark wie die Rolle pepsi (Eine kompromittierte Komponente). Die Stage schützt den Ruf der Domain, nicht eine Vorliebe eines Benutzers; führen Sie sie nie in EDITABLE_STAGES auf (Adressbezogene Einstellungen sind eine Vertrauensgrenze).
39.4. State¶
Eingaben:
state.local_originund die Ingress-Urteilestate.auth.dmarc/state.auth.dkim, die entscheiden, ob eine Nachricht, derenFrom:mit der signierenden Domain ausgerichtet ist, signiert wird; die Domain stammt ausSIGNING_DOMAINoder der Spaltefrom_header, der Body-Hash aus der geladenen Nachricht.Ausgaben: auf dem Signierpfad nur
state.origin.body_8bit, gelöscht, wenn der Nachrichtentext nach 7 Bit konvertiert wurde; der Rest vonstate, einschließlichstate.dsn, bleibt erhalten. Ansonsten schreibt nur eine Ablehnung oder eine Wiederholung etwas (state.last_error;state.bouncebei Umleitung zuBOUNCE_STAGE;state.temporary_failuresbei einer Wiederholung).
39.5. Siehe auch¶
pepsi-stage-bounce, pepsi-stage-relay-to-internet, Unterstützte Funktionen, pepsi-stage-dkim-sign(1).