95.1.10. pepsi-stage-bounce¶
rewrite a message into a delivery-status bounce
- Handbuchabschnitt:
1
95.1.10.1.1. Name¶
pepsi-stage-bounce - die Bounce-Erzeugungs-Stage der Pepsi-Pipeline.
95.1.10.1.2. Übersicht¶
pepsi-stage-bounce [GLOBAL-OPTIONS] worker
95.1.10.1.3. Beschreibung¶
pepsi-stage-bounce ist ein Stage-Programm: pepsi-dispatch(1) führt es als persistenten Worker aus, der Nachrichten-IDs von der Standardeingabe liest. Jede ID bezeichnet einen Datensatz der pepsi.workqueue-Tabelle. Die Stage lädt diesen Datensatz, weigert sich zu handeln, sofern sein status nicht running ist, und liest ihre eigene Konfiguration aus dem [stage-<stage>]-Abschnitt der Nachricht (siehe pepsi.conf(5)).
Es schreibt die Nachricht an Ort und Stelle in eine RFC-3464-Zustellungsstatusbenachrichtigung (DSN) um: Der Umschlagabsender wird zum Null-Absender (<>), der Umschlagempfänger zum Absender der ursprünglichen Nachricht, und der Nachrichtentext wird zu einem multipart/report, der die ursprünglichen Header zitiert.
„Der Absender der ursprünglichen Nachricht“ ist state.srs.original, wenn pepsi-stage-srs(1) einen solchen festgehalten hat, und andernfalls die mail_from-Spalte. Der Unterschied zählt auf jedem weiterleitenden Pfad, denn SRS läuft notwendigerweise vor der Zustell-Stage. Wenn hier eine DSN verfasst wird, ist der Umschlagabsender bereits einer unserer eigenen SRS-Aliase. Ein Bericht an ihn ginge hinaus zum nächsten Hop und käme über unseren eigenen MX wieder herein, um dekodiert zu werden. Er durchliefe als Null-Absender-Nachricht die gesamte eingehende Pipeline und erreichte erst dann eine Adresse, die die ganze Zeit auf dem Datensatz stand. SRS ist ein Rückweg für einen Bounce, den der nächste Hop erzeugt; ein Bericht, den wir selbst schreiben, braucht diesen Umweg nicht. Siehe pepsi.state(7). Standardmäßig ist dies ein Failure-Bounce (Action: failed); wenn die routende Stage state.bounce mit kind = success markiert, ist es stattdessen ein positiver (Action: delivered-)Bericht. Die Diagnose und der Empfänger werden dem state entnommen, den die routende Stage auf dem Datensatz hinterlassen hat. Das From: der DSN ist Mail Delivery Subsystem <POSTMASTER>, und POSTMASTER ist standardmäßig postmaster@SERVER_NAME. Die umgeschriebene DSN bleibt unsigniert; der Datensatz wird zum NEXT_STAGE der Stage weitergeschaltet, normalerweise pepsi-stage-dkim-sign(1), das sie (als Domain des Postmasters) DKIM-signiert, bevor eine Zustell-Stage wie pepsi-stage-relay-to-internet(1) sie weiterleitet. Eine DSN ist reflektierte Mail: Sie wird gesendet, weil ein Fremder etwas gesendet hat, und zwar an eine Adresse, die der Fremde gewählt hat. Das Weiterschalten ist daher ein zurückgehaltenes: Der Datensatz geht für eine zufällige Zeit von bis zu [pepsi] REFLECTION_HOLD_MAX (Standardwert 30 s; siehe pepsi.conf(5)) paused zu NEXT_STAGE, und der Dispatcher gibt ihn danach frei. Das verhindert, dass Berichte vieler Hosts so getaktet werden, dass sie gleichzeitig bei einem Opfer landen.
Eine Nachricht, die bereits ein Bounce ist (sie hat den leeren Umschlagabsender), wird nicht umgeschrieben: Sie wird gelöscht und die Löschung protokolliert. Ein Bounce wird nie selbst gebounct (RFC 5321 §6.1).
Ein Bericht wird auch nicht an einen Umschlagabsender gesendet, den die eingehende Nachricht nicht authentifiziert hat, weder durch einen SPF-Pass für seine Domain noch durch einen ausgerichteten DKIM-Pass für ein From: an dieser Domain (oder einer Eltern- oder Subdomain davon). Spam fälscht seinen Absender, sodass ein Bounce dafür bei einem unbeteiligten Dritten landet (Backscatter), und das bringt diesen Host auf Sperrlisten. Eine solche Nachricht wird mit einer Warnung im Log verworfen. Schlug sie auf diesem Host fehl statt beim nächsten Hop, nennt die Warnung die Stage und den festgehaltenen Fehler. Ein vorübergehender DNS-Fehler ist kein Urteil, daher wird ein Bericht gesendet, wenn ein solcher Fehler eine Prüfung für die eigene Domain des Absenders gestoppt hat (SPF für den Umschlagabsender oder DMARC oder eine Signatur dieser Domain für ein From: dort) und weder SPF noch DMARC eindeutig fehlgeschlagen sind. Ein Fehler zu einer anderen Domain zählt nicht: Ein Fälscher wählt die Domain einer Signatur selbst und kann verhindern, dass ihr DNS antwortet. Mail, die unsere eigenen Benutzer eingeliefert haben, und Nachrichten, die eine Stage selbst erzeugt hat (ganz ohne state.auth), werden immer gemeldet. BOUNCE_UNAUTHENTICATED = send schaltet die Prüfung ab.
DSN (RFC 3461): Ein Failure-Bounce wird nur erzeugt, wenn das NOTIFY des fehlgeschlagenen Empfängers FAILURE angefordert hat. Die Stage richtet sich nach NOTIFY, ORCPT und ENVID, die die routende Zustell-Stage aus dem state.dsn-Eintrag des Empfängers auf das state.bounce-Objekt kopiert hat. Wird kein NOTIFY mitgeführt, ist der Standardwert FAILURE, sodass gewöhnliche Mail weiterhin bounct; aber NOTIFY=NEVER (oder eine NOTIFY-Liste ohne FAILURE) bedeutet, dass der Absender keinen Fehlerbericht will, und die Nachricht wird dann ohne Bounce verworfen. Wenn das ursprüngliche ENVID und ORCPT angegeben waren, werden sie als Original-Envelope-Id und Original-Recipient in die DSN übernommen.
Wenn pepsi-stage-aliases(1) oder pepsi-stage-dot-forward(1) einen Empfänger durch Expansion der Adresse erzeugt hat, die der Absender verwendete, wird der Empfänger als diese Adresse gemeldet. Die Expansion hält die Adresse fest (expanded_from im state.dsn-Eintrag des Empfängers, den die Zustell-Stage auf state.bounce kopiert), und jede DSN über das Ziel nennt sie als Final-Recipient. Eine solche DSN hat einen generischen Diagnostic-Code derselben Klasse (550 <status> delivery to a forwarded address failed, 450 … is delayed) und behält den erweiterten Status:-Code. Wohin der Alias oder das ~/.forward eines Benutzers führt und was der Host dort geantwortet hat, sind die Daten des Benutzers, nicht die des Absenders (RFC 3464 Abschnitt 4.2, RFC 3461 Abschnitt 5.2.7.4); das Ziel und die echte Diagnose werden für den Betreiber in das Journal geschrieben, und die BOUNCE_MESSAGE-Vorlage sieht weder sie noch die Felder remote_mta, smtp_code, phase und reply_text.
Ein Bericht, den ein nachgelagerter Server über eine solche Kopie sendet, wird auf dieselbe Weise beantwortet. Die Kopie ging mit einer Weiterleitungs-Rücksendeadresse hinaus (pepsi-stage-srs(1)), und pepsi-ingress(1) verwandelt einen Bericht an diese Adresse in einen Datensatz bei dieser Stage, statt ihn zuzustellen. Der Datensatz hat den ursprünglichen Absender als Umschlagabsender und die Adresse, die der Absender verwendete, als Empfänger. Sein state.bounce trägt die Action des Berichts (failed oder delay bei Action: delayed) und die Statusklasse sowie das NOTIFY des Absenders. Der Datensatz hat außerdem state.forward_return = true, state.crypto.in, wenn die Nachricht verschlüsselt eintraf, und ein unbewiesenes state.auth, wenn ihr Absender nicht authentifiziert war, damit BOUNCE_UNAUTHENTICATED greift. Sein Header-Block enthält die eigenen Adressierungsfelder des Absenders aus den zurückgegebenen Headern des Berichts, oder nichts bei einer verschlüsselt eingetroffenen Nachricht; eine DSN ohne etwas zu zitieren hat keinen dritten Teil (RFC 6522 Abschnitt 3 macht ihn optional).
Eine Nachricht, die auf diesem Host fehlschlug, kommt ohne state.bounce an: Der Fehler einer Stage wurde bis MAX_LIFETIME wiederholt oder als permanent markiert, die Nachricht brachte ihren Worker zum Absturz oder Hängen, oder pepsi-failure-bouncer(1) hat einen failed-Datensatz hierher verschoben. Ein solcher Datensatz kann noch mehrere Empfänger aufführen, jeder mit eigenem NOTIFY, daher wird er zuerst in einen Datensatz pro Empfänger aufgeteilt, und für jede Kopie wird dann gemäß dem eigenen state.dsn-Eintrag dieses Empfängers (einschließlich RET) berichtet oder sie wird verworfen. Die Diagnose ist ein bewusst generischer Satz, gewählt nach state.failure_class, der höchstens die Stage nennt (state.failed_stage): Das festgehaltene state.last_error kann Dateien, Datenbankobjekte und Hosts nennen, daher bleibt es im Datensatz und im Journal und wird nie in eine DSN kopiert. Der Status: ist 5.4.7 für retries-exhausted, 5.3.0 für crashed/timed-out, 5.6.0 für permanent, 5.7.1 für quarantine-expired und sonst 5.0.0.
Ein Success-Bericht (kind = success) wird nur erzeugt, wenn der Empfänger ausdrücklich NOTIFY=SUCCESS angefordert hat (Success hat, anders als Failure, keinen impliziten Standardwert); die routende Stage gibt einen ausschließlich dann aus, wenn das globale [pepsi]-ORIGINATE_SUCCESS_DSN aktiviert ist. Ein Delay-Bericht (kind = delay, Action: delayed) wird nur erzeugt, wenn der Empfänger NOTIFY=DELAY angefordert hat; eine Zustell-Stage reiht hier eine Kopie einer noch nicht zugestellten Nachricht ein (siehe DELAY_DSN_AFTER in pepsi-stage-relay-to-internet(1)), während das Original weiterhin wiederholt wird. Sowohl success als auch delay haben keinen impliziten Standardwert.
Der menschenlesbare (text/plain-)Teil des Bounces ist standardmäßig ein eingebauter englischer Hinweis. Wenn die BOUNCE_MESSAGE-Option der Stage eine Vorlage benennt, wird dieser Teil stattdessen aus bounce-<NAME>.<lang>.body unter dem [pepsi]-TEMPLATE_DIR gerendert (eine Mustache-Vorlage; siehe pepsi.conf(5)). <lang> wird aus state.language in dessen q-Reihenfolge gewählt, mit Rückfall auf en. Der Bounce geht an den Absender der ursprünglichen Nachricht, und die Sprache, die pepsi-stage-detect-language(1) in der Nachricht gefunden hat, die er geschrieben hat, ist der beste verfügbare Anhaltspunkt dafür, was er liest. Das ist eine Näherung, und wo keine Erkennung lief (üblicherweise auf dem Submission-Pfad), ist der Hinweis englisch. Eine Nachricht, deren Inhalt aus einem S/MIME-EnvelopedData stammt oder sich daraus nicht öffnen ließ (AES-CBC, kein Integritätsschutz), gilt als ohne erkannte Sprache: Die Sprache hängt davon ab, ob sich ein verändertes CBC-Chiffrat öffnen ließ, und eine DSN in dieser Sprache würde es dem Absender verraten. Der Rendering-Kontext ist das gesamte Nachrichten-state, außer dem, was die eingehenden Krypto-Stages festgehalten haben (state.crypto, state.encrypted, state.signature_verified; siehe Verschlüsselt eingetroffene Mail). Er wird ergänzt um die Variablen der obersten Ebene server_name, postmaster, bounce_to, failed_recipient, diagnostic, action (failed/delayed/delivered) und die drei Wahrheitswerte failed / delayed / delivered. Mit den Angaben zum nächsten Hop, die eine Zustell-Stage erfasst hat (state.bounce.remote_mta / smtp_code / enhanced_status / phase / reply_text), kann der Bounce daher genau angeben, warum der nächste MTA die Nachricht abgelehnt hat. Das Rendering erfolgt nach bestem Bemühen: Jeder Fehler fällt auf den eingebauten Text zurück, sodass immer ein Bounce erzeugt wird.
pepsi-stage-bounce führt keine Netzwerkzustellung durch und gibt keine Benachrichtigung aus; die umgeschriebene Nachricht wird von der Stage zugestellt, die NEXT_STAGE benennt.
95.1.10.1.4. Konfiguration¶
Die Optionen der Bounce-Stage (SERVER_NAME, POSTMASTER, die erforderliche NEXT_STAGE, die optionale BOUNCE_MESSAGE-Vorlage, RET_FULL_MAX_SIZE und BOUNCE_UNAUTHENTICATED) sind in pepsi.conf(5) dokumentiert.
95.1.10.1.5. Die Nachricht zurücksenden (RET)¶
Der dritte Teil der DSN zitiert die fehlgeschlagene Nachricht. Standardmäßig ist das ihr Header-Block, als text/rfc822-headers. Wenn der ursprüngliche Absender RET=FULL bei MAIL FROM gesetzt hat, wird stattdessen die ganze Nachricht zurückgesendet, als message/rfc822, worum RFC 3461 §6.2 bittet. pepsi-ingress(1) hält den RET-Parameter fest, und er erreicht diese Stage in state.bounce.ret.
Die Ausnahme ist die Größe. §6.2 erlaubt es, allein die Header zurückzusenden, wenn die Nachricht „eine implementierungsspezifische Größe überschreitet“; RET_FULL_MAX_SIZE ist diese Größe (Standardwert 256 KiB, gemessen über die gesamte gespeicherte Nachricht). Oberhalb dieser Größe fällt die DSN stillschweigend auf die Header-Form zurück und protokolliert das. Der Wert 0 schaltet die Grenze ab, sodass eine RET=FULL-Nachricht stets vollständig zurückgesandt wird. Der Nachrichtentext wird nur für eine Nachricht aus der Datenbank gelesen, die darum gebeten hat und hineinpasst, sodass ein gewöhnlicher Bounce weiterhin ein Laden nur der Header kostet.
Jeder zitierte Header-Block und der Header-Block einer zurückgegebenen Nachricht verliert Pepsis eigene X-Pepsi-*-Anmerkungsfelder: Sie melden, was die eingehenden Stages gefunden haben, und sind für den Empfänger gedacht, nicht für den Umschlagabsender, wer immer das ist.
Eine mit REQUIRETLS markierte Nachricht (state.tls_required = "required", siehe pepsi-ingress(1)) wird nur mit ihren Headern zitiert, gleich was RET verlangt: RFC 8689 §5 schreibt vor, RET=FULL für eine solche Nachricht zu ignorieren, weil ihr Bounce einen Rückweg ohne den Schutz nehmen kann, den die Nachricht selbst verlangte. Die hier gebaute DSN trägt dieselbe Markierung, sodass die Relay-Stages sie nur über validiertes TLS zurückgeben und REQUIRETLS weitergeben, wo der Rückweg es ankündigt.
95.1.10.1.6. Verschlüsselt eingetroffene Mail¶
Eine Nachricht, die mit Chiffrat eintraf (state.crypto.in hält sie als encrypted oder decrypted fest), wird nur mit ihren Adressierungsfeldern zitiert: From, Sender, To, Cc, Date und Message-ID, als text/rfc822-headers, gleich was RET verlangt. Kein Subject, kein Nachrichtentext.
Wir tun das, um zwei Angriffe zu vermeiden. pepsi-stage-decrypt(1) läuft zuerst auf dem eingehenden Pfad, sodass eine Nachricht, für die später in der Pipeline ein Bounce entsteht (eine unbezahlte Pay-to-Send-Schranke, ein volles Postfach, ein ablehnender LMTP-Server), Klartext enthält. Ein Angreifer, der ein Chiffrat abgefangen hat, kann es unter seinem eigenen Umschlagabsender mit RET=FULL erneut senden, dafür sorgen, dass es als Bounce zurückkommt, und den Klartext erhalten; authentifizierte Verschlüsselung hilft nicht, weil das Chiffrat nicht verändert wird. Zweitens würde eine DSN, die sich zwischen einer Nachricht, die sich öffnen ließ, und einer, die sich nicht öffnen ließ, unterscheidet (die Betreffmarkierung [decrypted], das Feld X-Pepsi-Crypto, ein entschlüsselter Nachrichtentext), dem Absender verraten, ob sich ein verändertes Chiffrat noch entschlüsseln lässt, was der Baustein von Padding-Orakel-Angriffen auf AES-CBC-S/MIME ist. Dieselben Felder in beiden Fällen zurückzuhalten entfernt dieses Signal aus dem Inhalt der DSN. Was bleibt, ist, ob überhaupt eine DSN gesendet wird, und ihr Diagnosetext, die davon abhängen, was wo fehlschlug, nicht vom Klartext. Die Bounce-Einstellungen von pepsi-stage-decrypt(1) und pepsi-stage-reencrypt(1) verwerfen eine Nachricht, deren Chiffrat keinen Integritätsschutz hatte, statt einen Bounce zu erzeugen, sodass auch die Existenz einer DSN dem Absender nicht verrät, ob sich ein verändertes AES-CBC-Chiffrat öffnen ließ.
Die an den Umschlagabsender adressierten automatischen Antworten folgen derselben Regel: pepsi-stage-vacation(1), die Zahlungsaufforderung von pepsi-stage-anti-spam(1) und die Challenge von pepsi-stage-secretary(1) zitieren nicht den Betreff einer verschlüsselt eingetroffenen Nachricht.
95.1.10.1.7. State¶
Eingaben: state.bounce, der Berichtskontext, den die routende Stage auf dem Datensatz hinterlassen hat. Sein kind (permanent ⇒ ein Failure-Action: failed-Bericht, success ⇒ Action: delivered, delay ⇒ Action: delayed) wählt den Berichtstyp; diagnostic und failed_recipient werden darin zitiert; die optionalen notify/orcpt/envid entscheiden, ob der Bericht überhaupt ausgegeben wird und was übernommen wird; das optionale expanded_from ersetzt den Empfänger und die Diagnose (siehe oben); ret wählt, ob die ganze Nachricht oder nur ihre Header zurückgesendet werden (siehe oben); und die optionalen strukturierten Felder zum nächsten Hop remote_mta/smtp_code/enhanced_status/phase/reply_text (von den Relay-Stages geschrieben) werden der BOUNCE_MESSAGE-Vorlage und, für enhanced_status, dem DSN-Status:-Feld zugänglich gemacht (andernfalls ist Status: je nach Art 5.0.0, 4.0.0 oder 2.0.0). Ein Datensatz ohne state.bounce wird stattdessen aus state.failed_stage/state.failure_class und seinem state.dsn berichtet (siehe Beschreibung); state.last_error wird immer nur protokolliert. state.srs.original, state.auth und state.local_origin wählen und prüfen den Empfänger der DSN, state.crypto.in entscheidet, ob Inhalt zurückgehalten wird, und state.language wählt die Sprache der Vorlage. Eine andere Stage kann einen Bericht als eigenen Datensatz neben dem Original erzeugen (ein Bounce oder eine Erfolgsmeldung je Empfänger von pepsi-stage-relay-to-maildir oder pepsi-stage-discard, die Verzögerungswarnung eines Relays). Ein solcher Datensatz trägt den state der ursprünglichen Nachricht mit seinem eigenen bounce-Eintrag obenauf, sodass diese Schlüssel diese Stage für ihn genauso erreichen wie für eine umgeleitete Nachricht; nur state.list und die Wiederholungs- und Fehlerbuchführung des ursprünglichen Datensatzes bleiben zurück.
Ausgaben: Die Stage schreibt die Nachricht an Ort und Stelle um und ersetzt state durch einen einzigen Schlüssel, retry_since (den Zeitpunkt, zu dem die DSN gebaut wurde), sodass die nachfolgenden Stages ihr MAX_LIFETIME ab dann zählen statt ab der Ankunft der ursprünglichen Nachricht. Trug das Original tls_required = "required", behält die Stage auch diesen Schlüssel; er ist das eine Stück des Zustands des Originals, das eine DSN behält (RFC 8689 §5). Der Bounce ist ansonsten eine neue Null-Absender-Nachricht, die keine der Herkunftsdaten des Originals erbt (dies ist die eine Stage, die state nicht bewahrt). Das State-Layout wird in pepsi.state(7) beschrieben.
Übergänge:
eine eingehende Nachricht, die selbst ein Bounce ist (Null-Absender) → abschließen (verworfen, nie erneut gebounct);
der Umschlagabsender ist nicht authentifiziert, kein vorübergehender DNS-Fehler entschuldigt das, und BOUNCE_UNAUTHENTICATED ist
drop→ abschließen (ohne DSN verworfen, als Warnung protokolliert);ein Datensatz ohne
state.bounceund mit mehr als einem Empfänger → zuerst in einen Datensatz pro Empfänger aufteilen (über die Kopien wird unabhängig berichtet);das
NOTIFYdes Empfängers fordert nicht den Bericht an, den dieseskindausgeben würde (Failure hat einen impliziten Standardwert;success/delaynicht) → abschließen (ohne DSN verworfen);andernfalls wird die Nachricht an Ort und Stelle in eine DSN umgeschrieben und zu NEXT_STAGE weitergeschaltet (das Signier-/Zustell-Ende).
Die Stage selbst pausiert nie, schlägt nie fehl und leitet nie um. Ein Fehler (etwa eine nicht erreichbare Datenbank) wird wie bei jeder Stage wiederholt; eine Bounce-Stage nennt normalerweise kein BOUNCE_STAGE, daher hinterlässt eine, die MAX_LIFETIME überdauert, den Datensatz failed, und pepsi-failure-bouncer(1) lässt einen Datensatz, der an der Bounce-Stage fehlschlug, wo er ist.
95.1.10.1.8. Befehle¶
- worker
Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest.
95.1.10.1.9. Globale Optionen¶
Diese globalen Optionen stehen vor dem Unterbefehl.
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit (
error,warn,info,debugodertrace; Standardwert[pepsi] LOG, sonstinfo).- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen, einschließlich Drittanbieter-Bibliotheken.
- -h, –help
Gibt eine Verwendungsübersicht aus und beendet sich.
- -V, –version
Gibt die Version aus und beendet sich.
95.1.10.1.10. Exit-Status¶
Das Ergebnis jeder Nachricht wird pepsi-dispatch(1) auf der Statuszeile des Workers gemeldet, nicht als Exit-Status.
- 0
Der Worker lief, bis seine Standardeingabe geschlossen wurde.
- 1
Ein fataler Fehler ist aufgetreten (unlesbare Konfiguration, die Datenbank konnte nicht geöffnet werden, oder Standardein-/-ausgabe schlug fehl). Der Grund wird in das Journal geschrieben.
- 78
Der Abschnitt der Stage lässt sich nicht parsen oder nennt keine NEXT_STAGE: Der Worker verweigert den Start, und pepsi-dispatch(1) hält die Nachrichten der Stage zurück, bis die Konfiguration korrigiert ist.
95.1.10.1.11. Beispiele¶
Die Bounce-Stage von Hand auf Nachricht 42 ausführen (sie muss running sein):
echo 42 | pepsi-stage-bounce -c /etc/pepsi/pepsi.conf worker
95.1.10.1.12. Siehe auch¶
pepsi-config(1), pepsi.conf(5), pepsi.state(7), pepsi-stage-dkim-sign(1), pepsi-dispatch(1), pepsi-stage-relay-to-internet(1), pepsi-stage-relay-to-smarthost(1), pepsi-setup(1), pepsi-failure-bouncer(1)
„Unknown recipients and backscatter“ und „Bounces and replies to encrypted mail“ im Sicherheitskapitel des Pepsi-Handbuchs sowie „Loops and amplification“ in seinem Bedrohungsmodell.
95.1.10.1.13. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.