95.1.11. pepsi-stage-relay-to-internet¶
deliver a message directly to the recipient’s MX hosts
- Handbuchabschnitt:
1
95.1.11.1.1. Name¶
pepsi-stage-relay-to-internet - die Direkt-zu-MX-Zustell-Stage der Pepsi-Pipeline.
95.1.11.1.2. Übersicht¶
pepsi-stage-relay-to-internet [GLOBAL-OPTIONS] worker
pepsi-stage-relay-to-internet [GLOBAL-OPTIONS] mta-sts DOMAIN
95.1.11.1.3. Beschreibung¶
pepsi-stage-relay-to-internet ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest. Es lädt diesen pepsi.workqueue-Datensatz (und weigert sich zu handeln, sofern sein status nicht running ist), liest seinen [stage-<stage>]-Abschnitt und stellt die Nachricht direkt an die Mail-Exchanger der Empfängerdomain zu, unter Verwendung des eigenen Umschlagabsenders der Nachricht (des Null-Absenders <> bei Bounces). Die Zustellung erfolgt mit einem Empfänger je Versuch: Ein Datensatz, der noch mehrere Empfänger enthält, wird zunächst in einen Datensatz je Empfänger aufgeteilt (jeder mit seinem Ausschnitt von state.dsn), die alle erneut in diese Stage eintreten. Eine Nachricht mit mehr als MAX_HOP_COUNT Received:-Headerfeldern wird als Mailschleife behandelt und schlägt dauerhaft fehl.
Es führt seine eigene DNS-MX-Abfrage durch: Kandidaten-Hosts werden in aufsteigender MX-Präferenz versucht (Hosts gleicher Präferenz in zufälliger Reihenfolge), eine Domain ohne MX-Einträge fällt auf ihre Adress-Einträge zurück (der implizite MX von RFC 5321 §5.1), und eine nicht existierende Domain oder ein RFC-7505-Null-MX ist ein dauerhafter Fehler. Ein Null-MX wird als 556 mit dem erweiterten Status 5.1.10 gemeldet (RFC 7505 §4.1), damit der Bounce sagt, dass die Adresse nie zustellbar sein kann, statt wie jedes andere 550 auszusehen. Die A/AAAA-Adressen jedes MX-Hosts werden mit Happy-Eyeballs ausgewählt und pro Adresse in der dns_address-Tabelle zwischengespeichert; die ADDRESS_FAMILY-Einstellung (mit den Familien geschnitten, die der Host routen kann) wählt, welche zu verwenden ist. Verbindungen werden auf Port 25 hergestellt. Jede Abfrage erfolgt für den vollqualifizierten Namen, sodass eine search-Liste in /etc/resolv.conf nie angewandt wird: andernfalls würde eine Domain ohne MX-Einträge ein zweites Mal unter jeder Such-Domain nachgeschlagen. Gemeldet würde dann das daraus entstehende NXDOMAIN statt des NODATA der Domain selbst, was eine gewöhnliche Zustellung über den impliziten MX in einen dauerhaften Fehler verwandelt.
Sofern nicht mit MTA_STS = no deaktiviert, wird die MTA-STS-Richtlinie der Empfängerdomain (RFC 8461) beachtet: Eine enforce-Richtlinie beschränkt die Zustellung auf die gelisteten MX-Hosts über STARTTLS mit einem Zertifikat, das für den Host gültig ist, und lässt die Nachricht (vorübergehend) fehlschlagen, wenn kein MX passt. Eine testing-Richtlinie wird auf dieselbe Weise validiert, und der Versuch und sein Ergebnis werden für TLS-Reporting festgehalten, aber sie blockiert nie die Zustellung: Ein Transportsicherheitsfehler (oder eine Richtlinie, die auf keinen MX passt) fällt auf opportunistisches STARTTLS über alle MX-Hosts zurück, sodass der Domain-Eigentümer aus den Berichten lernt, ob enforce Mail brechen würde, bevor er darauf umschaltet. Domains ohne Richtlinie verwenden opportunistisches STARTTLS. Richtlinienabfragen sind nur dann fail-open, wenn nichts zwischengespeichert ist; mit eingeschaltetem TLS-Reporting wird ein fehlgeschlagener Abruf einer angekündigten Richtlinie dann als sts-policy-fetch-error festgehalten (sts-webpki-invalid bei einem Zertifikat, das für den Namen des Richtlinien-Hosts oder gegen die System-Wurzeln nicht validierte), höchstens einmal pro Domain und Worker alle fünf Minuten, sodass der Domain-Eigentümer erfährt, dass sein Richtlinien-Host nicht erreichbar war. Die Richtliniendatei wird nur von einer öffentlichen Adresse abgerufen: Ein Richtlinien-Host, der ausschließlich auf Loopback, einen privaten oder Link-Local-Bereich (Cloud-Metadaten eingeschlossen), CGNAT, Unique-Local-IPv6 oder eine andere nicht öffentliche Adresse auflöst, wird nicht kontaktiert, da eine Empfängerdomain den Abruf sonst ins Innere der Installation richten könnte; das zählt als fehlgeschlagener Abruf.
Richtlinien werden für ihr max_age (auf eine Woche gedeckelt) in der Tabelle pepsi.mta_sts_policy zwischengespeichert, die sich jeder Worker teilt und die das Recyceln von Workern und Neustarts überdauert, sodass eine einmal abgerufene Richtlinie durchgesetzt bleibt, auch wenn der _mta-sts-Eintrag später entfernt oder der Richtlinien-Host blockiert wird (RFC 8461 §5.1); ein abgelaufener Datensatz wird nie durchgesetzt, und pepsi-queue gc löscht ihn. Nur verwendbare (enforce/testing) Richtlinien werden gespeichert. Die _mta-sts-TXT-id wird bei jeder Verwendung einer zwischengespeicherten Richtlinie erneut geprüft (RFC 8461 §3.1): Eine geänderte id löst einen sofortigen erneuten Abruf aus, während ein vorübergehend unerreichbarer Eintrag (oder ein fehlgeschlagener erneuter Abruf einer geänderten Richtlinie) die noch gültige zwischengespeicherte Richtlinie behält. Ein Richtlinien-Host, der ein vorübergehendes 5xx/429 zurückgibt, wird als „Abruf fehlgeschlagen“ behandelt (fail-open, nicht als „keine Richtlinie“ zwischengespeichert), während ein 404, ein Nicht-text/plain-Rumpf, mode: none oder eine nicht parsebare Richtlinie eine definitive Abwesenheit ist: Sie entfernt eine zwischengespeicherte Richtlinie für die Domain, und jeder Worker merkt sie sich (nur im Speicher) fünf Minuten lang, bevor er erneut fragt.
Eine zwischengespeicherte Richtlinie wird bei Verwendung aufgefrischt, sobald weniger als die Hälfte ihrer Lebensdauer (ihres max_age, auf eine Woche gedeckelt) übrig ist (RFC 8461 Abschnitt 10.2): Die Richtliniendatei wird erneut abgerufen, auch wenn die id unverändert ist oder der _mta-sts-Eintrag verschwunden ist, und ein erfolgreicher Abruf speichert die Richtlinie wieder für ihre volle Lebensdauer, sodass eine regelmäßig angeschriebene Domain nie wieder einen „Erstkontakt“ erreicht. Eine Auffrischung, die fehlschlägt oder unter der unveränderten id keine verwendbare Richtlinie findet, behält die zwischengespeicherte Richtlinie (eine Domain zieht ihre Richtlinie zurück, indem sie mode: none unter einer neuen id veröffentlicht, RFC 8461 Abschnitt 8.3); der Worker wartet dann fünf Minuten, bevor er es erneut versucht, und sobald weniger als ein Viertel der Lebensdauer übrig ist, wird jeder Fehlschlag als Warnung protokolliert, sodass eine ständig fehlschlagende Auffrischung bemerkt wird, bevor die Richtlinie verfällt.
Gespeicherte Richtlinien werden auch aufgefrischt, ohne dass eine Nachricht nach ihnen fragt, wie RFC 8461 Abschnitt 10.2 es verlangt: pepsi-queue(1) gc, stündlich ausgeführt, ruft jede gespeicherte Richtlinie, deren halbe Lebensdauer verstrichen ist (oder die weniger als drei Stunden übrig hat), nach denselben Regeln ab und verwendet dabei DNS_SERVERS, DNS_TIMEOUT und MTA_STS_TIMEOUT des ersten Stage-Abschnitts, der dieses Programm mit eingeschaltetem MTA_STS ausführt. Eine Domain, die weiterhin eine Richtlinie veröffentlicht, fällt daher nie auf einen Erstkontakt zurück, wie selten sie auch angeschrieben wird; eine Richtlinie, deren Auffrischungen ständig fehlschlagen, wird behalten, bis ihr max_age abläuft.
DANE (RFC 7672): Wenn DANE strict (der Standard) oder warn ist und der Ziel-MX-Host DNSSEC-validierte TLSA-Einträge veröffentlicht, wird das MX-Zertifikat gegen sie statt per PKIX authentifiziert; dies hat für diese Verbindung Vorrang vor MTA-STS. DANE beruht auf DNSSEC. Pepsi vertraut dem AD-(Authentic-Data-)Bit der Antwort, statt selbst zu validieren, daher muss der konfigurierte Resolver (DNS_SERVERS, sonst [pepsi] DNS_SERVERS, sonst resolv.conf) validieren und über einen vertrauenswürdigen Pfad erreicht werden: Loopback oder DNS over TLS oder HTTPS (ein tls://- oder https://-Eintrag, siehe pepsi.conf(5)). TLSA- (und MX-)Antworten ohne das AD-Bit werden als „kein DANE“ behandelt. Ein mit eingeschaltetem DANE gestarteter Worker protokolliert eine Warnung, wenn dieser Resolver weder eine Loopback-Adresse ist noch über einen verschlüsselten Eintrag erreicht wird, und eine weitere, wenn er nicht validiert: Der Worker fragt ihn nach dem signierten SOA von ietf.org und warnt, wenn der Antwort das AD-Bit fehlt (DANE ist dann konfiguriert, wird aber nie angewendet) oder keine kommt. pepsi-status(1) zeigt dieselbe Prüfung in seinem Abschnitt „DNSSEC-Resolver“. Im strict-Modus schiebt ein nutzbarer Eintrag, der nicht übereinstimmt, die Nachricht als vorübergehenden Fehler auf, wie RFC 7672 Abschnitt 2.2 verlangt, und ebenso eine fehlgeschlagene TLSA- oder MX-Sicherheitsabfrage (zum Beispiel für einen DNSSEC-bogus-Eintrag). Im warn-Modus, einem ausdrücklichen Opt-out für Betreiber, die lieber Mail an Peers mit veralteten TLSA-Einträgen weiterfließen lassen, wird die Nichtübereinstimmung protokolliert, und die Zustellung fährt mit der unverifizierten Zertifikatsprüfung fort, die ohne DANE gilt. So oder so ist STARTTLS für einen solchen Host verpflichtend (RFC 7672 Abschnitt 2.2: Ein gesichertes TLSA-RRset bedeutet, dass jede Verbindung zum Host TLS verwenden muss): warn lockert die Zertifikatsprüfung, nie TLS selbst. Bietet ein Host kein STARTTLS an oder entfernt ein Angreifer das Angebot aus der Antwort, wird die Nachricht aufgeschoben statt im Klartext gesendet.
Dieser Vorrang gilt nur dort, wo DANE mindestens so stark ist wie das, was es ersetzt. Für einen Host, der von einer enforce-MTA-STS-Richtlinie abgedeckt ist, wird der warn-Modus nicht verwendet, denn eine Nichtübereinstimmung im warn-Modus nimmt jedes Zertifikat an, was die Validierungsanforderung der Richtlinie nach RFC 8461 §5 verwerfen würde. Stattdessen wird das Zertifikat per PKIX validiert und die Ersetzung protokolliert. Der strict-Modus hat dort weiterhin Vorrang. Eine Domain, die einfach keine TLSA-Einträge veröffentlicht, wird selbst im strict-Modus normal zugestellt: DANE ist opportunistisch und greift nur, wenn Einträge existieren. Eine Domain, die TLSA-Einträge veröffentlicht, von denen keiner nutzbar ist (eine PKIX-Verwendung oder ein Matching-Typ, den dieser Build nicht implementiert), ist nicht dasselbe: Nach RFC 7672 §2.2 hat sie den Host dennoch auf TLS festgelegt. STARTTLS wird für ihn daher verpflichtend, unauthentifiziert, aber nie im Klartext, und ein Hop, der es nicht anbietet, schiebt die Nachricht auf. Wo eine Verwendung und ein Selektor sowohl mit einem SHA-256- als auch mit einem SHA-512-Eintrag veröffentlicht sind (Matching-Typen 1 und 2), werden nur die SHA-512-Einträge abgeglichen (RFC 7671 Abschnitt 9, Agilität des Digest-Algorithmus): Der schwächere Digest wird nur für Clients veröffentlicht, denen der stärkere fehlt, und ihn trotzdem abzugleichen ließe die Verbindung genau so stark wie diesen schwächeren Digest. Matching-Typ 0 (die vollständigen Daten) wird immer abgeglichen.
Widerruf (RFC 6960): Wo immer das MX-Zertifikat per PKIX validiert wird (unter einer MTA-STS-Richtlinie, für eine REQUIRETLS-Nachricht oder als warn-Rückfall von DANE), wird eine OCSP-Antwort, die der Server im Handshake anheftet (RFC 6066 status_request), gegen den Aussteller des Zertifikats oder einen vom Aussteller autorisierten Responder verifiziert. Eine aktuelle revoked-Antwort lässt die Sitzung wie jeden anderen Zertifikatsfehler abweisen; bei einer opportunistischen Sitzung wird sie nur protokolliert. Eine fehlende, veraltete oder nicht verifizierbare Antwort lässt das Zertifikat ungeprüft, und es wird nie ein Responder abgefragt. Bei einem DANE-TA-Treffer (Verwendung 2) wird die angeheftete Antwort auf dieselbe Weise ausgewertet, und ein verifiziertes revoked hebt den Treffer auf. Für ein Zertifikat, zu dem ein DANE-EE-Eintrag (Verwendung 3) passte, wird die angeheftete Antwort nicht herangezogen: Dieser Eintrag bindet die Sitzung an den Schlüssel, den die Domain jetzt veröffentlicht.
Require TLS (RFC 8689): Eine mit state.tls_required = "required" markierte Nachricht (sie traf mit dem REQUIRETLS-Parameter von MAIL FROM ein, siehe pepsi-ingress(1)) wird nur unter den Bedingungen von RFC 8689 §4.2.1 gesendet, gleich was die Empfängerdomain veröffentlicht. Ihre MX-Hostnamen müssen validiert sein, entweder durch DNSSEC (das MX-RRset trägt das AD-Bit, was eingeschaltetes DANE und einen validierenden Resolver braucht) oder durch eine MTA-STS-Richtlinie. Eine MTA-STS-Richtlinie zählt im enforce- wie im testing-Modus, da es der authentifizierte Abruf und der Host-Abgleich der Richtlinie sind, die die Namen validieren. Eine Domain, die keines von beiden bietet, ist ein dauerhafter Fehler (5.7.10). STARTTLS ist verpflichtend, und das Zertifikat wird durch DANE authentifiziert, wo der Host verwendbare TLSA-Einträge veröffentlicht (eine Nichtübereinstimmung im warn-Modus fällt hier auf PKIX zurück, nie auf die Prüfung, die alles annimmt), und sonst per PKIX gegen die System-Wurzeln (RFC 6125, der MX-Hostname). Nach dem Upgrade muss der Host REQUIRETLS ankündigen, und der Parameter wird weitergegeben. Ein Host, der bei irgendetwas davon versagt, erhält ein QUIT, und der nächste MX-Host wird versucht; kann keiner die Nachricht annehmen, wird für sie ein Bounce mit 5.7.30 (kein REQUIRETLS beim Hop) oder 5.7.10 (kein validiertes TLS) erzeugt. Ist ein Host aus einem vorübergehenden Grund gescheitert, den eine Wiederholung beheben könnte, wird die Nachricht stattdessen wiederholt. Der Bounce ist selbst markiert: Er reist unter derselben Anforderung, gibt nur Header zurück (RET=HDRS, RFC 8689 §5) und wird mit dem Parameter gesendet, wo der Rückweg ihn ankündigt, aber nicht für einen Hop abgelehnt, dem die Erweiterung fehlt (§5); ein Bounce, der sich unter der Anforderung nicht zurückgeben lässt, wird verworfen, und seine Postmaster-Kopie unterliegt derselben Regel. Eine mit "no" markierte Nachricht (sie trug TLS-Required: No) wird gemäß RFC 8689 §4.2.2 an jeden MX-Host über opportunistisches STARTTLS zugestellt: Eine enforce-MTA-STS-Richtlinie beschränkt weder die Hosts noch verlangt sie TLS, und verwendbare TLSA-Einträge werden abgeglichen, eine Nichtübereinstimmung warnt aber nur. Ein Handshake, der fehlschlägt, nachdem STARTTLS angeboten wurde, wird dennoch nie im Klartext wiederholt (ein Angreifer könnte diesen Fehlschlag erzwingen), sodass ein solcher Hop die Nachricht aufschieben lässt. Sitzungen einer "no"-Nachricht werden nicht für TLS Reporting festgehalten: Der Urheber hat verlangt, dass Richtlinienfehler ignoriert werden, also geht ein solcher Fehler den Domain-Eigentümer nichts an.
SMTP TLS Reporting (RFC 8460): Wenn [pepsi-tlsrpt] SEND_REPORTS gesetzt ist, wird das Ergebnis jeder TLS-Sitzung als Aggregat-Zähler in pepsi.tls_session festgehalten, geschlüsselt nach der angewandten Richtlinie (tlsa/sts/no-policy-found) und MX-Host. Das Ergebnis ist ein Erfolg oder ein klassifizierter Fehler (starttls-not-supported, Zertifikat/Handshake oder DANE/MTA-STS-Validierung). pepsi-tlsrpt(1) stellt diese später zu täglichen Berichten zusammen. Das Festhalten erfolgt nach bestem Bemühen (ein Datenbank-Schluckauf lässt eine Zustellung nie fehlschlagen) und wird für eine Berichtsnachricht selbst übersprungen (state.tlsrpt).
Ein Host, der die Sitzung mit einer 5xx-Antwort auf die Begrüßung, auf EHLO, HELO oder STARTTLS ablehnt, hat nichts über den Empfänger gesagt, daher wird der nächste MX-Host versucht (RFC 5321 Abschnitt 5.1). Eine solche Ablehnung wird nur dann als dauerhafter Fehler gemeldet, wenn kein Host die Nachricht annimmt und keiner vorübergehend fehlgeschlagen ist; ein 5xx auf MAIL FROM, RCPT TO oder DATA beendet den Versuch sofort.
Ein Host, der EHLO mit 500 oder 502 beantwortet, kennt den Befehl nicht, daher begrüßt ihn die Stage stattdessen mit HELO (RFC 5321 Abschnitt 3.2). Ein solcher Host kündigt keine Erweiterung an: Die Nachricht wird wo nötig in 7 Bit umgewandelt, und ein Hop, der TLS verwenden muss, schlägt vorübergehend fehl, weil er kein STARTTLS anbietet.
Bei Erfolg wird der Datensatz entfernt (oder, falls die Stage NEXT_STAGE setzt, weitergeschaltet). Ein vorübergehender Fehler pausiert die Nachricht mit einem exponentiellen Backoff (von pepsi-dispatch(1) erneut eingereiht, wenn ihr timeout abläuft); nach MAX_LIFETIME wird der Fehler als dauerhaft behandelt. Ein dauerhafter Fehler einer gewöhnlichen Nachricht wird zum BOUNCE_STAGE der Stage geroutet (oder, ohne ein konfiguriertes, wird der Datensatz als failed markiert). Ein dauerhafter Fehler eines Bounces (Null-Absender) wird nie erneut gebounct. Ist POSTMASTER gesetzt, ist der Datensatz das Letzte, was vom Bericht übrig ist, daher wird er erst entfernt, wenn dort eine Kopie zugestellt wurde. Solange der Mail-Exchanger des Postmasters die Kopie aufschiebt, wird der Datensatz wie jeder andere wiederholt, und wird die Kopie abgelehnt oder bleibt sie über MAX_LIFETIME hinaus aufgeschoben, wird der Datensatz als failed markiert, damit ein Betreiber ihn findet. pepsi-failure-bouncer(1) entfernt einen solchen Datensatz nach seinem MIN_AGE, da ein Bounce nie gebounct wird. Ohne POSTMASTER wird der Bounce verworfen, ebenso ein an POSTMASTER selbst adressierter Bounce.
DSN (RFC 3461): Wenn der MX des Empfängers die DSN-Erweiterung ankündigt, werden die Parameter, die der Ursprung angefordert hat, an ihn propagiert: RET/ENVID und das NOTIFY/ORCPT des Empfängers, aus dem state.dsn des Datensatzes gelesen. Andernfalls werden sie weggelassen. Bei einem dauerhaften Fehler werden das NOTIFY/ORCPT des Empfängers und das ENVID an die Bounce-Stage übergeben, sodass eine Failure-DSN nur dann erzeugt wird, wenn angefordert. Diese Stage bewahrt state.dsn.
RRVS (RFC 7293): Ein Empfänger, der mit einem RRVS=-Parameter eintraf (in state.dsn.rcpt aufbewahrt), gibt ihn unverändert weiter, einschließlich der Aktion bei fehlender Unterstützung, wenn der MX RRVS ankündigt. Tut er das nicht, lässt die Standardaktion R den Empfänger dauerhaft mit 5.7.19 fehlschlagen (eine DSN, sodass der Absender erfährt, dass die Anforderung nicht durchgesetzt werden konnte), und C macht weiter, wobei die Anforderung als Require-Recipient-Valid-Since:-Header-Feld geschrieben wird, das diesen einen Empfänger nennt – jede Relay-Transaktion trägt einen einzigen Empfänger, sodass das Feld nie das Datum eines Empfängers einem anderen offenlegt.
Wenn das globale [pepsi]-ORIGINATE_SUCCESS_DSN aktiviert ist und der Empfänger einer erfolgreichen Zustellung NOTIFY=SUCCESS angefordert hat, wird die Nachricht (nach der Zustellung) zu BOUNCE_STAGE geroutet, das einen positiven (Action: delivered-)Bericht an den Absender ausgibt. Mit ausgeschaltetem Flag oder ohne eine SUCCESS-Anforderung wird eine erfolgreiche Zustellung einfach abgeschlossen.
Wenn DELAY_DSN_AFTER gesetzt ist und eine noch nicht zugestellte Nachricht mindestens so lange eingereiht war, wird dem Absender eine einmalige „verzögerte“ (Action: delayed-)DSN gesendet — aber nur, wenn der Absender NOTIFY=DELAY angefordert hat (Delay hat keinen impliziten Standardwert). Die ursprüngliche Nachricht wird weiterhin wiederholt; die Warnung ist eine separate Nachricht, die durch BOUNCE_STAGE geroutet und höchstens einmal gesendet wird.
Herkunftsnachweis: Wenn der gemeinsame [pepsi-origin]-Abschnitt konfiguriert ist (standardmäßig an; pepsi-setup(1) erzeugt ein Geheimnis, wenn keines gesetzt ist), wird jede ausgehende Nachricht vor der Zustellung mit einem Pepsi-Origin-Header gestempelt, und die Nonce wird in pepsi.origin_nonce festgehalten (zwei Wochen gültig). Der Header enthält einen HMAC über das Ursprungs-Absenderkonto, eine frische 128-Bit-Nonce, einen Zeitstempel und unser HOSTNAME. Dasselbe Stempeln wird mit pepsi-stage-relay-to-smarthost(1) geteilt, sodass eine Nachricht einen Nachweis erhält, welchen ausgehenden Pfad sie auch nimmt. Ein zurückkehrender Bounce bettet diesen Header ein und lässt pepsi-stage-anti-spam(1) bestätigen, dass der Bounce eine Antwort auf Mail ist, die wir tatsächlich gesendet haben. Der Header wird wie der Received:-Trace-Header vorangestellt (über etwaige bestehende Signaturen, sodass er keine stört) und bleibt unsigniert. Eine Nonce, die sich nicht festhalten lässt (ein Datenbankfehler), hält die Nachricht zurück, und sie wird wie jeder Fehler des Hosts wiederholt (siehe pepsi-dispatch(1)): Ein Header, dessen Nonce nicht verzeichnet ist, ließe jeden Bounce auf die Nachricht gefälscht aussehen. Ohne den [pepsi-origin]-Abschnitt wird kein Header hinzugefügt; ein Abschnitt, dessen Geheimnis sich nicht lesen lässt, hindert die Worker der Stage am Start (die Warteschlange wird angehalten, und das Journal sagt, warum), genau wie pepsi-setup(1) ihn ablehnt.
Inhalts-Herabstufung (RFC 6152 / RFC 6531): Die Nachricht wird an die Erweiterungen angepasst, die der MX tatsächlich ankündigt, statt wörtlich gesendet zu werden. Wenn der Nachrichtentext 8-Bit-Oktette enthält und der MX 8BITMIME unterstützt, trägt der Umschlag BODY=8BITMIME; wenn er es nicht tut, wird der MIME-Baum durchlaufen und jeder 8-Bit-Blattteil mit einer 7-Bit-Content-Transfer-Encoding umkodiert (Quoted-Printable für text/*, sonst Base64). Was ein Teil deklariert, gilt nicht als Beweis dafür, was er enthält: Ein als base64 gekennzeichneter Teil, der rohe 8-Bit-Oktette trägt, wird ebenfalls umkodiert, und ein multipart/*, dessen deklariertes boundary= nirgends in seinem Nachrichtentext vorkommt, hat keine zu erhaltenden Teile und wird als Ganzes kodiert. Das Ergebnis wird dann erneut geprüft, denn der Durchlauf erfolgt nach bestem Bemühen über eine Nachricht, die niemand validiert hat (ein über die Tiefengrenze hinaus geschachtelter Baum wird unverändert durchgereicht): Ein Nachrichtentext, der weiterhin 8-Bit-Oktette trägt, ist ein dauerhafter Fehler (554) und nichts, was man auf die Leitung gibt, was RFC 6152 §3 „unter allen Umständen“ verbietet.
Wenn die Nachricht SMTPUTF8 benötigt (UTF-8 in den Headern oder im Umschlag) und der MX es unterstützt, trägt der Umschlag SMTPUTF8; wenn er es nicht tut, werden UTF-8-Header-Felder als RFC-2047-Encoded-Words umgeschrieben. Sie stehen an den drei Stellen, an denen RFC 2047 §5 eines erlaubt, damit das Feld weiterhin parst: einem unstrukturierten Feldinhalt, einer Display-Name-phrase (ein Quoted-String wird zu einem Encoded-Word, ohne die Anführungszeichen) und dem Inneren eines comment (die Klammern bleiben). Ein Nicht-ASCII-Parameter von Content-Type oder Content-Disposition, für den §5 kein Encoded-Word kennt, erhält stattdessen die erweiterte Form von RFC 2231 (filename*=UTF-8''caf%C3%A9.txt, aufgeteilt in *0*/*1*-Abschnitte, wenn eine Zeile ihn nicht fassen würde); ASCII-Parameter werden unverändert übernommen. Dies betrifft den Header-Block jedes MIME-Teils, nicht nur den der Nachricht, denn dort steht der Dateiname eines Anhangs. Ein Nicht-ASCII-boundary= hat überhaupt keine kodierte Form: Es muss Oktett für Oktett mit den Begrenzungszeilen des Nachrichtentexts übereinstimmen, und RFC 2046 erlaubt dafür nur 7-Bit-Zeichen. Statt für die Nachricht einen Bounce zu erzeugen, gibt Pepsi dem Multipart eine frische zufällige ASCII-Begrenzung und schreibt seine Begrenzungszeilen passend um. Ein Teil-Header, der sich nicht umwandeln lässt (etwa rohe Latin-1-Oktette), wird unverändert kopiert und der erneuten 8BITMIME-Prüfung überlassen, da der Transport ihn als Inhalt des Nachrichtentexts sieht. Eine Nicht-ASCII-Umschlagadresse und ein Nicht-ASCII-Oktett innerhalb einer Header-Adresse können nicht herabgestuft werden: Gegenüber einem Hop ohne SMTPUTF8 ist eine solche Nachricht ein dauerhafter Fehler (Bounce). Das Umkodieren eines Nachrichtentexts zerstört zwangsläufig jede den Nachrichtentext abdeckende Signatur, die bereits auf der Nachricht ist (der DKIM-Body-Hash des Urhebers und die ARC-Message-Signature von pepsi-stage-arc(1)); dies ist unvermeidbar, da die Fähigkeiten des MX erst nach der MX-Auswahl bekannt sind, und in der Praxis selten. Pepsis eigene DKIM-Signatur ist im üblichen Fall nicht betroffen: pepsi-stage-dkim-sign(1) konvertiert einen 8-Bit-Nachrichtentext vor dem Signieren nach 7 Bit, sodass hier nichts mehr umzukodieren ist.
95.1.11.1.4. Konfiguration¶
Die Pipeline-Verdrahtung und jede Betriebsoption liegen im eigenen [stage-<name>]-Abschnitt der Stage (PROGRAM = pepsi-stage-relay-to-internet): die Identitäten SERVER_NAME/POSTMASTER, EHLO_FROM_PTR (den vorwärts bestätigten PTR-Namen der lokalen Adresse jeder Verbindung ankündigen), die Verbindungs-Timeouts, der Retry-Backoff-Zeitplan und MAX_LIFETIME, DELAY_DSN_AFTER, MAX_HOP_COUNT, die DNS-Einstellungen, MTA_STS/MTA_STS_TIMEOUT, ADDRESS_FAMILY und DANE. Sie sind in pepsi.conf(5) dokumentiert.
95.1.11.1.5. State¶
Eingaben (aus dem state des Datensatzes gelesen; alle optional):
state.dsn— die RFC-3461-Parameter (ret/envidauf Nachrichtenebene und dasnotify/orcptdes ersten Empfängers); an den MX propagiert, wenn erDSNankündigt, und herangezogen, um Failure-/Success-/Delay-Berichte abzuriegeln.state.origin— die 8BITMIME/SMTPUTF8-Hinweise (body_8bit,smtputf8), die von der Inhalts-Herabstufungs-Entscheidung verwendet werden.state.tls_required— die Markierung nach RFC 8689 ("required"oder"no"), siehe Require TLS oben.
Ausgaben (in das state des Datensatzes zusammengeführt):
Bei einem vorübergehenden Fehler (
pause):attempts,last_errorund, sobald eine Delay-DSN ausgegeben wurde,delay_sent.Bei einem dauerhaften Fehler mit einem
BOUNCE_STAGE(reroute) oder bei einer Delay-Warnung (einem eingereihten Klon): einstate.bounce-Objekt (kind=permanentoderdelay) für pepsi-stage-bounce(1). Für einen Fehler auf SMTP-Ebene hält es außerdem die strukturierten Detailangaben zum nächsten Hop fest —remote_mta(die Domain des Empfängers),smtp_code,enhanced_status,phaseundreply_text— sodass der Bounce genau angeben kann, warum die Zustellung verweigert wurde.Bei einer erfolgreichen Zustellung mit
ORIGINATE_SUCCESS_DSNundNOTIFY=SUCCESS: einstate.bounce-Objekt mitkind = success.Bei einem dauerhaften Fehler ohne
BOUNCE_STAGE(fail):last_error.
state.dsn, state.origin und state.tls_required bleiben immer erhalten. Das State-Layout wird vollständig in pepsi.state(7) beschrieben.
Übergänge (der Wiederholungszeitplan ist RETRY_INITIAL / RETRY_FACTOR / RETRY_MAX_INTERVAL, begrenzt durch MAX_LIFETIME):
erfolgreiche Zustellung → abschließen (der Datensatz wird gelöscht) oder zu NEXT_STAGE weiterschalten, falls eines gesetzt ist; mit [pepsi] ORIGINATE_SUCCESS_DSN und einem Empfänger, der
NOTIFY=SUCCESSangefordert hat, leitet es stattdessen zu BOUNCE_STAGE um, um eine positive (Action: delivered-)DSN auszugeben;vorübergehender Fehler → pausieren für das nächste Wiederholungsintervall;
noch eingereiht über DELAY_DSN_AFTER hinaus mit einem
NOTIFY=DELAY-Empfänger → einen einmaligen Delay-DSN-Klon bei BOUNCE_STAGE einreihen (das Original bleibt eingereiht und wiederholt weiter);dauerhafter Fehler oder MAX_LIFETIME erschöpft → umleiten zu BOUNCE_STAGE oder fehlschlagen (terminal
failed), wenn kein BOUNCE_STAGE konfiguriert ist;ein unzustellbarer Bounce (Null-Absender) wird nie erneut gebounct: Mit gesetztem POSTMASTER wird die Zeile abgeschlossen, sobald dort eine Kopie zugestellt ist, pausiert, solange die Kopie aufgeschoben wird, und als failed markiert, wenn die Kopie abgelehnt wird oder MAX_LIFETIME erschöpft ist; ohne diese Option wird die Zeile abgeschlossen.
95.1.11.1.6. Befehle¶
- worker
Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest.
- mta-sts DOMAIN
Diagnose: die MTA-STS-Richtlinie nachschlagen und ausgeben, die bei der Zustellung an DOMAIN gelten würde. Verwendet den System-Resolver und benötigt keine Nachrichten- oder Stage-Konfiguration.
95.1.11.1.7. Globale Optionen¶
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit (Standardwert
[pepsi] LOG, sonstinfo).- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen.
- -h, –help; -V, –version
Gibt eine Verwendungsübersicht / die Version aus und beendet sich.
95.1.11.1.8. 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, oder die mta-sts-Abfrage wurde abgeschlossen.
- 1
Ein fataler Fehler ist aufgetreten (die Konfigurationsdatei konnte nicht gelesen werden, die Datenbank konnte nicht geöffnet werden, oder Standardein-/-ausgabe schlug fehl). Der Grund wird in das Journal geschrieben.
- 78
Der Worker hat den Start verweigert: Sein
[stage-<name>]-Abschnitt,[pepsi],[pepsi-tlsrpt]oder[pepsi-origin]lässt sich nicht parsen (oder das Herkunftsgeheimnis lässt sich nicht lesen), oder das Datenbankschema passt nicht zu diesem Build. Der Dispatcher reiht erneut ein, was er übergeben hatte, und versucht die Stage später wieder.
95.1.11.1.9. Beispiele¶
Die Stage auf Nachricht 42 ausführen (sie muss running sein):
echo 42 | pepsi-stage-relay-to-internet -c /etc/pepsi/pepsi.conf worker
Prüfen, welche MTA-STS-Richtlinie für eine Empfängerdomain gilt:
pepsi-stage-relay-to-internet -c /etc/pepsi/pepsi.conf mta-sts example.com
95.1.11.1.10. Siehe auch¶
pepsi-config(1), pepsi-stage-bounce(1), pepsi-stage-dkim-sign(1), pepsi-stage-relay-to-smarthost(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
Die Garantien der Transportsicherheit und ihre Grenzen (was ein aktiver Netzwerkangreifer mit und ohne MTA-STS oder DANE noch tun kann) stehen im Kapitel Threat model des Pepsi-Handbuchs; die Tabelle der privilegierten Programme und die Annahme über den DNS-Resolver stehen in seinem Kapitel Security.
95.1.11.1.11. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.