40. pepsi-stage-bounce¶
Schreibt eine Nachricht in eine Zustellungsstatusbenachrichtigung (DSN) um.
40.1. Rolle¶
pepsi-stage-bounce verwandelt eine Nachricht in eine RFC-3464-DSN: einen Fehler-Bounce oder, auf Anforderung, einen positiven oder einen Delay-Bericht. Eine Zustell-Stage routet eine fehlgeschlagene/zugestellte Nachricht über ihr BOUNCE_STAGE hierher. Die DSN wird unsigniert erzeugt und nach einem zufälligen Zurückhalten von bis zu [pepsi] REFLECTION_HOLD_MAX (30 s), wie jede reflektierte Mail (Unbekannte Empfänger und Backscatter), zu NEXT_STAGE weitergeschaltet (normalerweise pepsi-stage-dkim-sign, dann eine Zustell-Stage). Referenzen: pepsi-stage-bounce(1) / pepsi.conf(5).
40.2. Funktionen¶
Umschreiben an Ort und Stelle in eine DSN (RFC-3464-
multipart/report): Der Umschlagabsender wird zum Null-Absender<>, der Empfänger zum ursprünglichen Absender (state.srs.original, wenn pepsi-stage-srs einen festgehalten hat, sonst die Spaltemail_from), und der Nachrichtentext zitiert die ursprünglichen Header; es werden erweiterte RFC-3463-Statuscodes verwendet.RET=FULL (RFC 3461 §6.2): Hat der Absender die ganze Nachricht zurückverlangt, holt die Stage den Nachrichtentext und sendet ihn vollständig zurück. Das ist der eine zusätzliche Round-Trip im Baum, und er wird nur für eine solche Nachricht unternommen. Überschreitet der Nachrichtentext
RET_FULL_MAX_SIZE(Standardwert 256 KiB,0schaltet die Grenze ab), fällt die DSN auf die Header allein zurück, wie es §6.2 ausdrücklich erlaubt.Vom Betreiber gelieferter Fließtext. Benennt
BOUNCE_MESSAGEeine Vorlage, so wird der menschenlesbare Teil der DSN ausbounce-<NAME>.<lang>.bodyunter[pepsi] TEMPLATE_DIRmit dem vollständigenstatedes Datensatzes gerendert.<lang>folgtstate.languageinq-Reihenfolge, mit Rückfall aufen: Der Hinweis geht an den ursprünglichen Absender, und die in dessen Nachricht erkannte Sprache ist der beste verfügbare Anhaltspunkt dafür, was er liest (ohne Spracherkennung auf dem Pfad ist der Hinweis englisch). Jeder Renderfehler fällt auf den eingebauten Text zurück, sodass immer ein Bounce erzeugt wird.NOTIFY-bewusst (RFC 3461): Ein Fehler-Bericht wird nur ausgegeben, wenn
NOTIFYFAILUREangefordert hat (der Standardwert bei Abwesenheit);NOTIFY=NEVER(oder eine Liste ohneFAILURE) verwirft die Nachricht stillschweigend.Drei Berichtsarten, ausgewählt durch
state.bounce.kind:permanent→Action: failed(der standardmäßige Fehler-Bounce);success→Action: delivered(nur wenn eine Zustell-Stage es unterORIGINATE_SUCCESS_DSN+NOTIFY=SUCCESSerzeugt hat);delay→Action: delayed(eineDELAY_DSN_AFTER-Warnung einer Relay-Stage).
Spiegelt das ursprüngliche
ENVID/ORCPTinOriginal-Envelope-Id/Original-Recipient, wenn vorhanden.Hält Weiterleitungsadressen vertraulich: Für einen Empfänger, den eine Alias- oder
~/.forward-Expansion erzeugt hat (expanded_from), nennt die DSN die vom Absender verwendete Adresse alsFinal-Recipientund gibt einen generischenDiagnostic-Codederselben Klasse an (550 <status> delivery to a forwarded address failed), wobei der erweiterteStatus:erhalten bleibt; das Ziel und die echte Antwort gehen nur in das Journal (RFC 3464 §4.2). Dieselbe DSN beantwortet den Bericht eines entfernten Hosts über eine weitergeleitete Kopie: pepsi-ingress verwandelt einen an die Weiterleitungs-Rücksendeadresse der Kopie gesendeten Bericht in einen Datensatz bei dieser Stage (state.forward_return) und verwirft den Bericht (Weiterleitungsadressen in Zustellberichten).Nichts zu zitieren, kein dritter Teil: Hat eine DSN nichts von der Nachricht zu zitieren, ist sie ein zweiteiliger
multipart/report(RFC 6522 §3). Das ist beim Bericht über eine weitergeleitete Kopie einer verschlüsselt eingetroffenen Nachricht der Fall.Erzeugt niemals einen Bounce auf einen Bounce (RFC 5321 §6.1): Eine Null-Absender-Nachricht wird gelöscht, nicht umgeschrieben.
Kein Backscatter (
BOUNCE_UNAUTHENTICATED, Standardwertdrop): Kein Bericht geht an einen Umschlagabsender, den die eingehende Nachricht nicht authentifiziert hat (SPF-Pass für seine Domain oder ein ausgerichteter DKIM-Pass für einFrom:in dieser Domain oder einer Eltern- oder Subdomain davon). Von unseren eigenen Benutzern eingelieferte Mail und von einer Stage erzeugte Nachrichten (keinstate.auth) werden immer berichtet; ein verworfener Bericht über einen Fehler auf diesem Host wird als Warnung protokolliert.Fehler auf diesem Host (kein
state.bounce: Der Fehler einer Stage überdauerteMAX_LIFETIMEoder war permanent, ein Worker-Absturz oder pepsi-failure-bouncer): Der Datensatz wird in einen Datensatz pro Empfänger aufgeteilt, das eigenestate.dsn-NOTIFY/ORCPT/RETjedes Empfängers wird beachtet, und die DSN trägt eine generische Diagnose, gewählt nachstate.failure_class(Status:5.4.7,5.3.0,5.6.0,5.7.1oder5.0.0);state.last_errorwird nie hineinkopiert.Inhalt verschlüsselt eingetroffener Mail wird zurückgehalten: Gleich was
RETverlangt, zitiert die DSN nurFrom/Sender/To/Cc/Date/Message-ID, ob die Entschlüsselung gelang oder nicht, sodass die DSN weder Klartext an denjenigen übergeben kann, der ein abgefangenes Chiffrat erneut gesendet hat, noch verraten kann, ob es sich öffnen ließ. Jeder zitierte Header-Block verliert PepsisX-Pepsi-*-Felder.Für eine ``REQUIRETLS``-Nachricht wird ein Bounce nur mit Headern erzeugt (RFC 8689 §5 missachtet
RET=FULL), und die DSN erbt die Markierungstate.tls_required, sodass die Relay-Stages sie nur über validiertes TLS zurückgeben.Keine Netzwerk-E/A: Die umgeschriebene Nachricht wird von demjenigen zugestellt, was
NEXT_STAGEbenennt; der Bounce bleibt für die DKIM-Sign-Stage unsigniert.
40.3. Sicherheit¶
Zwei der obigen Funktionen sind Sicherheitsmechanismen. Die Backscatter-Regel ist die zweite Schicht von „Unknown recipients and backscatter“ in Sicherheitsmodell (sie schützt den Senderuf des Hosts, Schutzgüter, gegen Ein entfernter Absender). Das Zurückhalten des Inhalts verschlüsselt eingetroffener Mail ist dort „Bounces and replies to encrypted mail“: Es verhindert, dass Klartext, den das Gateway geöffnet hat, den Umschlagabsender erreicht, wer immer das ist, und dass die DSN ein Entschlüsselungsorakel wird (Gateway-Verwahrung (custody = local, der MTA-Schlüssel), Bounces nach der Entschlüsselung am Gateway legen entschlüsselte Inhalte offen, CBC-Padding- und Format-Orakel gegen nicht authentifiziertes S/MIME). Die Diagnose eines Fehlers auf diesem Host zitiert nie state.last_error, das Dateien, Datenbankobjekte und Hosts nennen kann. Dass für einen Bounce nie ein Bounce erzeugt wird, ist Teil der Schleifenanalyse in Verfügbarkeit.
40.4. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-bounce, SERVER_NAME (erforderlich; verwendet in ``From:``/``Reporting-MTA``/``Message-ID``), POSTMASTER (das From: des Bounces und die DKIM-Identität; Standardwert postmaster@<SERVER_NAME>), BOUNCE_MESSAGE (der Vorlagenname; nicht gesetzt für den eingebauten Fließtext), RET_FULL_MAX_SIZE (Standardwert 256 KiB), BOUNCE_UNAUTHENTICATED (drop/send, Standardwert drop) und NEXT_STAGE (erforderlich; normalerweise eine DKIM-Sign-Stage: Die DSN wird unsigniert gebaut, ohne eine solche schlägt daher jeder Bounce fehl, nachdem die DSN bereits zusammengestellt wurde). Siehe pepsi.conf(5).
40.5. State¶
Eingaben:
state.srs.original(der DSN-Empfänger, falls vorhanden) undstate.bouncemitkind,diagnostic,failed_recipient, den strukturierten Angaben zum nächsten Hop, die die Relay-Stages festhalten (remote_mta/smtp_code/enhanced_status/phase/reply_text, was auch dasStatus:der DSN speist), und den kopiertennotify/orcpt/envid/ret. Ohnestate.bouncewird der Bericht ausstate.failed_stage/state.failure_classund demstate.dsn-Eintrag des Empfängers gebaut.state.auth/state.local_originprüfen den DSN-Empfänger,state.crypto.inentscheidet, ob Inhalt zurückgehalten wird, undstate.languagewählt die Sprache der Vorlage;state.tls_required(RFC 8689) erzwingt die Form nur mit Headern und wird auf die DSN übertragen. Ein Bericht, der als eigener Datensatz neben dem Original entsteht (ein Bounce oder eine Erfolgsmeldung je Empfänger, eine Verzögerungswarnung), trägt denstatedes Originals unter seinem eigenenbounce-Eintrag, sodass dieselben Prüfungen für ihn gelten. Der Header-Block wird geladen, der Nachrichtentext dagegen nur für einenRET=FULL-Bounce.Ausgaben: ersetzt
statedurch{"retry_since": <now>}, denn der Bounce ist eine neue Null-Absender-Nachricht, die nichts von der Herkunft des Originals erbt, und die späteren Stages zählen seinMAX_LIFETIMEab dem Zeitpunkt, an dem er gebaut wurde. Dies ist die einzige Stage, die das empfangenestateverwirft. Die anderen Stages behalten es und fügen eigene Schlüssel hinzu; eine Stage, die die Empfänger ändert, baut außerdem diestate.dsn-Einträge passend neu auf.
40.6. Siehe auch¶
pepsi-stage-dkim-sign, pepsi-stage-relay-to-internet, pepsi-stage-discard, pepsi-failure-bouncer, Unterstützte Funktionen, pepsi-stage-bounce(1), pepsi.conf(5).