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_ALGORITHMS schränkt das auf einen ein (die größten Empfänger verifizieren Ed25519 nicht und melden es in DMARC-Aggregatberichten als fail).

  • Signierdomain-Auswahl: SIGNING_DOMAIN, falls gesetzt, sonst die Domain des From:-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 mit l > 0 rundheraus 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 8BITMIME das 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 (eine DKIM-Signature oder ARC-Message-Signature an der Nachricht, ein multipart/signed-Teil), und auch nicht, wenn die Header der Nachricht SMTPUTF8 brauchen.

  • 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. Mit SIGNING_DOMAIN wird auch von außen empfangene Mail unsigniert weitergeschaltet, deren From: 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_DOMAIN und kein From:, das sich nur auf eine Weise lesen lässt), wenn pepsi-dkim(1) nicht für diese Domain signiert oder wenn das From: einer hier eingelieferten oder verfassten Nachricht nicht zur Organisation eines konfigurierten SIGNING_DOMAIN gehört. Eine solche Nachricht wird in einen Datensatz pro Empfänger aufgeteilt und mit einem DSN-Grund (5.6.0 oder 5.7.1) zum BOUNCE_STAGE der Stage umgeleitet. Ohne BOUNCE_STAGE oder bei einer Nachricht mit Null-Absender schlägt sie fehl (terminales failed, mit dem Grund in state.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 in state.last_error, bis zum MAX_LIFETIME der Stage (Standardwert 120 Stunden). Starten Sie pepsi-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_origin und die Ingress-Urteile state.auth.dmarc/state.auth.dkim, die entscheiden, ob eine Nachricht, deren From: mit der signierenden Domain ausgerichtet ist, signiert wird; die Domain stammt aus SIGNING_DOMAIN oder der Spalte from_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 von state, einschließlich state.dsn, bleibt erhalten. Ansonsten schreibt nur eine Ablehnung oder eine Wiederholung etwas (state.last_error; state.bounce bei Umleitung zu BOUNCE_STAGE; state.temporary_failures bei einer Wiederholung).

39.5. Siehe auch

pepsi-stage-bounce, pepsi-stage-relay-to-internet, Unterstützte Funktionen, pepsi-stage-dkim-sign(1).