95.1.5. pepsi-stage-srs¶
rewrite the envelope sender with the Sender Rewriting Scheme
- Handbuchabschnitt:
1
95.1.5.1.1. Name¶
pepsi-stage-srs - Stage der Pepsi-Pipeline zum SRS-Umschreiben des Umschlagabsenders.
95.1.5.1.2. Übersicht¶
pepsi-stage-srs [GLOBAL-OPTIONS] worker
pepsi-stage-srs [GLOBAL-OPTIONS] forward ADDRESS
pepsi-stage-srs [GLOBAL-OPTIONS] reverse ADDRESS
95.1.5.1.3. Beschreibung¶
Diese Stage hat den Standardwert FUSION = yes: Wenn Stage-Fusion aktiviert ist ([pepsi] ALLOW_FUSION, der Standardwert) und diese Stage in das vereinheitlichte pepsi-Binärprogramm eingefaltet ist, kann ein Vorgänger sie in seinem eigenen Worker-Prozess ausführen, statt sie separat zu dispatchen. Siehe pepsi-dispatch(1) und pepsi.conf(5).
pepsi-stage-srs ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest. Es implementiert das Sender Rewriting Scheme (SRS).
Wenn Pepsi eine Nachricht weiterleitet, behält es den Nachrichtentext unversehrt, leitet sie aber von seinen eigenen IP-Adressen weiter. Die SPF-Prüfung des nächsten Hops sieht dann, dass Pepsi Mail sendet, deren Umschlagabsender noch die Domain des ursprünglichen Absenders ist, die Pepsis IPs nicht autorisiert, und die Prüfung schlägt fehl. SRS löst dies, indem es den Umschlagabsender (MAIL FROM) in eine lokale Adresse einer von Pepsi kontrollierten Domain (SRS_DOMAIN) umschreibt, die den ursprünglichen Absender kodiert und ihn mit einem HMAC signiert:
SRS0=HHHH=TT=origin.example=alice@srs.example.net
SPF am nächsten Hop prüft nun srs.example.net, das legitim von Pepsis IPs sendet. Der Nachrichtentext und seine DKIM-Signaturen bleiben unberührt. Die Stage schaltet die Nachricht dann zu ihrem NEXT_STAGE (der Zustell-Stage) weiter. Außer dem Umschlagabsender ändert sie nur state.srs.original, wo sie den ursprünglichen Absender festhält. Der übrige state des Datensatzes bleibt unberührt, einschließlich etwaiger RFC-3461-Parameter in state.dsn, damit spätere Stages ihn beachten können.
Der Null-Absender (<>, d. h. ein zurückkehrender Bounce) wird nie umgeschrieben, und ein bereits in SRS_DOMAIN liegender Absender bleibt unverändert (das Umschreiben ist idempotent). Ist ein Absender bereits eine SRS-Adresse, weil die Nachricht Pepsi über einen anderen Weiterleiter erreichte, wird er in der kompakten SRS1-Form neu signiert, statt verschachtelt zu werden. So springt ein Bounce einen Weiterleiter nach dem anderen zurück.
95.1.5.1.3.1. Eine dedizierte Domain¶
SRS_DOMAIN muss eine eigene Domain sein, die mit keiner von diesem Host bedienten Domain DMARC-ausgerichtet ist. Die Umschreibung läuft für jede weitergeleitete Nachricht, unabhängig von ihrem DMARC-Ergebnis bei der Ankunft, und der SPF-Pass, den sie beim nächsten Hop einbringt, ist ein Pass für SRS_DOMAIN. Ist diese Domain mit der From:-Domain der Nachricht ausgerichtet, weil sie die bediente Domain selbst, eine Subdomain oder eine Elterndomain davon ist, ist der Pass ein ausgerichteter, und DMARC besteht allein darauf. Nehmen Sie eine als bediente Domain gefälschte Nachricht, die von außen empfangen wurde (wo sie DMARC nicht bestand) und an eine weiterleitende Adresse ging. Sie verließe diesen Host dann mit bestandenem DMARC: Die Weiterleitung wäscht die Fälschung rein. Mit einer dedizierten Domain besteht SPF weiterhin, aber es ist nicht mit dem From: ausgerichtet, sodass DMARC beim nächsten Hop auf der eigenen DKIM-Signatur des Autors beruhen muss, die eine getreue Weiterleitung behält und eine Fälschung nie hatte. (Die Signatur, die pepsi-stage-dkim-sign(1) weitergeleiteter Mail hinzufügen kann, wird für eine Nachricht zurückgehalten, die bei der Ankunft DMARC nicht bestand, sodass auch sie keine reinwaschen kann.)
pepsi-setup(1) lehnt daher eine SRS_DOMAIN ab, die mit einem ACCEPTED_DOMAINS-Eintrag oder einer anderen Sendeidentität ausgerichtet ist, sofern nicht [pepsi-srs] ALLOW_ALIGNED_DOMAIN = yes sie annimmt. Dann warnt es und nennt, was den Weg schließt (aspf=s im DMARC-Eintrag der bedienten Domain für eine Subdomain oder ein durchsetzendes p= mit [pepsi-ingress] DMARC_ENFORCE = yes), und pepsi-setup check prüft das gegen das Live-DNS. Der Assistent fragt nach einer dedizierten Domain, statt die primäre als Standard zu nehmen. Der Betreiber veröffentlicht das DNS der Domain: einen MX-Eintrag, der auf diesen Host zeigt (siehe unten), und den SPF-Eintrag, den pepsi-setup(1) dafür ausgibt, wie für jede Sendeidentität. Niemand schreibt Mail von dieser Domain, daher darf ihr DMARC-Eintrag p=reject sagen. Wenn der Assistent einen bestehenden Mailserver importiert und ein postsrsd daneben bereits in eine Domain umschreibt, wird diese Domain als Standard angeboten (Bounces von vor der Migration weitergeleiteter Mail sind an sie adressiert); eine ausgerichtete wird auch dort abgelehnt. Die Begründung steht unter „Forwarded forgeries of our own domain“ im Sicherheitskapitel des Pepsi-Handbuchs.
95.1.5.1.3.2. Gegenrichtung¶
pepsi-ingress(1) führt die andere Hälfte von SRS zur RCPT-Zeit durch, nicht dieses Programm: Es erkennt einen an eine SRS-Adresse zurückgesendeten Bounce, verifiziert seine Signatur und seinen Zeitstempel, dekodiert den ursprünglichen Absender und leitet den Bounce dorthin weiter. Ein Empfänger in SRS_DOMAIN, dessen Local-Part ein gültiges SRS-Token ist, wird angenommen und zurück zum ursprünglichen Absender umgeschrieben (obwohl die Domain dieses Absenders keine ist, die Pepsi bedient: Die gültige Signatur autorisiert das Relay); ein gefälschtes oder abgelaufenes Token wird mit 550 abgelehnt. Beide Richtungen lesen dieselbe gemeinsame [pepsi-srs]-Konfiguration, sodass Geheimnis und Domain übereinstimmen.
Diese Hälfte ist das, was SRS_DOMAIN zu einer Domain macht, die Post empfangen muss, und nicht bloß zu einer, als die dieser Rechner sendet. Den Umschlagabsender umzuschreiben macht Pepsi zum Bounce-Ziel für eine Nachricht, die es nicht geschrieben hat; veröffentlicht die Domain keinen MX und keinen Adresseintrag, wird der zurückkommende Bounce von dem MTA verworfen, der ihn zu senden versuchte, und der ursprüngliche Autor wird nie benachrichtigt. pepsi-setup(1) prüft das bei jedem Lauf unter seinen DNS-Gegenprüfungen, weil die SPF- und DMARC-Einträge der Domain auch ohne ihn vollständig aussehen.
95.1.5.1.3.3. Weitergeleitete Kopien¶
Eine Kopie, die ein Alias (pepsi-stage-aliases(1)) oder ein ~/.forward (pepsi-stage-dot-forward(1)) außerhalb der Site sendet, erhält keine SRS-Adresse. Ein solcher Empfänger trägt state.dsn.rcpt[].expanded_from (die vom Absender verwendete Adresse), und der Datensatz geht stattdessen mit einer Weiterleitungs-Rücksendeadresse hinaus:
fwd+<sealed record>=<tag>@srs.example.net
Der Datensatz wird mit aus dem SRS-Geheimnis abgeleiteten Schlüsseln verschlüsselt und authentifiziert (HMAC-SHA256 im SIV-Muster, ein 80-Bit-Tag; die Adresse ist kleingeschriebenes Base32). Er enthält den ursprünglichen Umschlagabsender, die vom Absender verwendete Adresse, ob die Nachricht verschlüsselt eintraf, ob der Absender authentifiziert war, das NOTIFY des Absenders für diesen Empfänger und den Tag, an dem er geprägt wurde; nichts davon ist in der Adresse lesbar. Ein Bericht, den ein entfernter Host über die Kopie sendet, kommt zu pepsi-ingress(1) zurück. Ingress nimmt ihn nur vom Null-Absender an und nur, solange sich der Datensatz verifizieren lässt und jünger als MAX_AGE_DAYS ist, und antwortet mit einer eigenen DSN dieses Hosts über die vom Absender verwendete Adresse. Der entfernte Bericht wird protokolliert und verworfen: Er würde das Weiterleitungsziel, die Antwort des dahinterstehenden Hosts und bei einer verschlüsselt eingetroffenen Nachricht den entschlüsselten Inhalt preisgeben. Eine SRS-Adresse hätte diesen Bericht unverändert an den Absender weitergeleitet.
Die Adresse ist zustandslos (nichts wird gespeichert) und daher lang: Zwei Adressen passen nicht in die 64 Oktette, die RFC 5321 einem Local-Part gibt, und eine typische ist 80 bis 120 Zeichen lang, wie die SRS-Adresse eines langen Absenders. Ihre Länge ist nicht begrenzt: Ein nächster Hop, der einen langen Umschlagabsender ablehnt, lässt die Zustellung fehlschlagen, und die DSN, die dieser Host dann schreibt, nennt wie jede andere DSN die vom Absender verwendete Adresse. Eine SRS-Adresse an ihrer Stelle ließe jeden, der einen langen Umschlagabsender wählt, den Weg wieder öffnen, den die Weiterleitungs-Rücksendeadresse schließt. Nur ein Absender, der sich überhaupt nicht versiegeln lässt (länger als 254 Oktette), lässt die Kopie mit dem Null-Absender hinausgehen, mit einer Warnung im Log. Der Null-Absender selbst wird nie umgeschrieben, sodass ein weitergeleiteter Bounce <> behält; ein Absender, der bereits in SRS_DOMAIN liegt, bleibt unverändert.
Der Umschlagabsender ist einer pro Datensatz. Ein Datensatz, dessen Empfänger unterschiedliche Absender bräuchten, etwa eine weitergeleitete Kopie und ein gewöhnliches Relay oder Kopien für zwei verschiedene Aliase, wird daher zuerst in einen Datensatz pro Empfänger aufgeteilt, von denen jeder für sich zu dieser Stage zurückkommt.
95.1.5.1.4. Konfiguration¶
Die Stage benötigt nur ein NEXT_STAGE in ihrem eigenen [stage-<name>]-Abschnitt (PROGRAM = pepsi-stage-srs); die SRS-Parameter (SRS_DOMAIN, SECRET/SECRET_FILE, PREVIOUS_SECRET_FILE, MAX_AGE_DAYS, ALLOW_ALIGNED_DOMAIN) liegen im Abschnitt [pepsi-srs], den die Stage mit pepsi-ingress(1) teilt. Alle sind in pepsi.conf(5) dokumentiert. Das Weglassen von [pepsi-srs] deaktiviert SRS: Ein Worker dieser Stage verweigert dann den Start (wie auch, wenn sich das Geheimnis nicht lesen lässt), sodass der Dispatcher die für sie eingereihten Nachrichten zurückhält, bis die Konfiguration korrigiert ist, statt sie fehlschlagen zu lassen, und pepsi-ingress(1) behandelt Empfänger, die wie SRS-Adressen aussehen, als gewöhnliche Adressen. Das Geheimnis wird für jede Nachricht neu gelesen, sodass ein rotiertes Geheimnis keinen Neustart erfordert; wird es unlesbar, während ein Worker läuft, wird die Nachricht mit Backoff wiederholt (siehe pepsi-dispatch(1)). Die Stage signiert nur mit SECRET; PREVIOUS_SECRET_FILE benennt ausgemusterte Geheimnisse, die pepsi-ingress(1) bei zurückkehrenden Adressen noch annimmt, sodass das Geheimnis ersetzt werden kann, ohne die bereits im Umlauf befindlichen Adressen zu brechen.
95.1.5.1.5. State¶
Eingaben: die Spalte mail_from; state.dsn.rcpt[].expanded_from und .notify (welche Empfänger weitergeleitete Kopien sind), state.crypto.in und der Authentifizierungsdatensatz state.auth / state.local_origin (in eine Weiterleitungs-Rücksendeadresse versiegelt).
Ausgaben: state.srs.original, der Umschlagabsender, den das Umschreiben ersetzt hat. Sonst wird nichts in state berührt; state.dsn und der Rest bleiben unverändert erhalten. Das State-Layout wird in pepsi.state(7) beschrieben.
Dieser eine Schlüssel existiert für eine DSN, die Pepsi nach dem Lauf dieser Stage erzeugt, was auf einem weiterleitenden Pfad jede DSN ist: Diese Stage geht der Zustell-Stage notwendigerweise voraus, sodass pepsi-stage-bounce(1) den Bericht sonst an unseren eigenen SRS-Alias adressieren und ihn damit auf eine Rundreise hinaus zum nächsten Hop und über unseren MX wieder herein zum Dekodieren schicken würde. Die Bounce-Stage liest stattdessen diesen Schlüssel, statt den Alias umzukehren, was das SRS-Geheimnis aus einer Stage heraushält, die nur Mail verfasst. Er wird nur geschrieben, wenn er fehlt, sodass eine zweimal umgeschriebene Nachricht die Adresse behält, die einen echten Korrespondenten benennt, und nicht den Zwischenalias.
Übergänge: schaltet zu NEXT_STAGE weiter, ob der Umschlagabsender umgeschrieben wurde oder unverändert durchlief (ein Null-Absender oder einer bereits in SRS_DOMAIN). Ein Datensatz, dessen Empfänger unterschiedliche Umschlagabsender brauchen, wird auf einen Empfänger pro Datensatz aufgeteilt und bei dieser Stage wieder eingereiht. Die Stage pausiert nie, schlägt nie fehl, leitet nie um und schließt nie ab.
95.1.5.1.6. Befehle¶
Als Worker ausgeführt, schreibt das Programm den Umschlagabsender jeder Nachricht um und schaltet sie weiter. Die Unterbefehle sind Betreiberwerkzeuge:
- forward ADDRESS
Gibt die SRS-Umschreibung von ADDRESS (die Vorwärtsrichtung) aus und beendet sich. Nützlich, um zu inspizieren, was aus einem bestimmten Absender wird.
- reverse ADDRESS
Dekodiert und verifiziert ADDRESS (eine SRS-Adresse oder ein bloßer Local-Part) und gibt den ursprünglichen Absender aus, oder schlägt fehl, wenn es keine gültige SRS-Adresse ist.
95.1.5.1.7. Globale Optionen¶
- -c FILE, –config FILE
Liest die Konfiguration aus FILE statt aus dem Standard-Suchpfad.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit (
error,warn,info,debug,trace; Standardwert[pepsi] LOG, sonstinfo).- -h, –help
Gibt eine Verwendungsübersicht aus und beendet sich.
- -V, –version
Gibt die Version aus und beendet sich.
95.1.5.1.8. Exit-Status¶
Das Ergebnis jeder Nachricht wird pepsi-dispatch(1) über die Statuszeile des Workers gemeldet, nicht als Exit-Status.
- 0
Der Worker lief, bis seine Standardeingabe geschlossen wurde, oder der Unterbefehl forward / reverse war erfolgreich.
- 1
Ein fataler Fehler ist aufgetreten (nicht lesbare Konfiguration, die Datenbank konnte nicht geöffnet werden, Standardeingabe/-ausgabe schlug fehl, oder reverse wurde eine Adresse übergeben, die keine gültige SRS-Adresse ist). Der Grund wird in das Log geschrieben.
- 78
Der Worker hat den Start verweigert:
[pepsi-srs]fehlt, lässt sich nicht parsen oder sein Geheimnis lässt sich nicht lesen (oder das Datenbankschema passt nicht zu diesem Binärprogramm). Der Dispatcher reiht erneut ein, was er übergeben hatte, und versucht die Stage später wieder.
95.1.5.1.9. Beispiele¶
Anzeigen, wozu ein Absender umgeschrieben wird:
pepsi-stage-srs -c /etc/pepsi/pepsi.conf forward alice@origin.example
Eine zurückgegebene Bounce-Adresse dekodieren:
pepsi-stage-srs -c /etc/pepsi/pepsi.conf reverse 'SRS0=HHHH=TT=origin.example=alice@srs.example.org'
95.1.5.1.10. Siehe auch¶
pepsi-config(1), pepsi-stage-relay-to-smarthost(1), pepsi-stage-relay-to-internet(1), pepsi-stage-bounce(1), pepsi-stage-dkim-sign(1), pepsi-dispatch(1), pepsi-ingress(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
95.1.5.1.11. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.