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 Spalte mail_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, 0 schaltet 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_MESSAGE eine Vorlage, so wird der menschenlesbare Teil der DSN aus bounce-<NAME>.<lang>.body unter [pepsi] TEMPLATE_DIR mit dem vollständigen state des Datensatzes gerendert. <lang> folgt state.language in q-Reihenfolge, mit Rückfall auf en: 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 NOTIFY FAILURE angefordert hat (der Standardwert bei Abwesenheit); NOTIFY=NEVER (oder eine Liste ohne FAILURE) 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 unter ORIGINATE_SUCCESS_DSN + NOTIFY=SUCCESS erzeugt hat);

    • delay → Action: delayed (eine DELAY_DSN_AFTER-Warnung einer Relay-Stage).

  • Spiegelt das ursprüngliche ENVID/ORCPT in Original-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 als Final-Recipient und gibt einen generischen Diagnostic-Code derselben Klasse an (550 <status> delivery to a forwarded address failed), wobei der erweiterte Status: 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, Standardwert drop): 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 ein From: in dieser Domain oder einer Eltern- oder Subdomain davon). Von unseren eigenen Benutzern eingelieferte Mail und von einer Stage erzeugte Nachrichten (kein state.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 überdauerte MAX_LIFETIME oder war permanent, ein Worker-Absturz oder pepsi-failure-bouncer): Der Datensatz wird in einen Datensatz pro Empfänger aufgeteilt, das eigene state.dsn-NOTIFY/ORCPT/RET jedes Empfängers wird beachtet, und die DSN trägt eine generische Diagnose, gewählt nach state.failure_class (Status: 5.4.7, 5.3.0, 5.6.0, 5.7.1 oder 5.0.0); state.last_error wird nie hineinkopiert.

  • Inhalt verschlüsselt eingetroffener Mail wird zurückgehalten: Gleich was RET verlangt, zitiert die DSN nur From/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 Pepsis X-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 Markierung state.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_STAGE benennt; 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) und state.bounce mit kind, 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 das Status: der DSN speist), und den kopierten notify/orcpt/envid/ret. Ohne state.bounce wird der Bericht aus state.failed_stage/state.failure_class und dem state.dsn-Eintrag des Empfängers gebaut. state.auth/state.local_origin prüfen den DSN-Empfänger, state.crypto.in entscheidet, ob Inhalt zurückgehalten wird, und state.language wä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 den state des Originals unter seinem eigenen bounce-Eintrag, sodass dieselben Prüfungen für ihn gelten. Der Header-Block wird geladen, der Nachrichtentext dagegen nur für einen RET=FULL-Bounce.

  • Ausgaben: ersetzt state durch {"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 sein MAX_LIFETIME ab dem Zeitpunkt, an dem er gebaut wurde. Dies ist die einzige Stage, die das empfangene state verwirft. Die anderen Stages behalten es und fügen eigene Schlüssel hinzu; eine Stage, die die Empfänger ändert, baut außerdem die state.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).