36. pepsi-stage-srs

Sender Rewriting Scheme — sorgt dafür, dass SPF beim nächsten Hop besteht.

36.1. Rolle

pepsi-stage-srs schreibt den Umschlagabsender in eine lokale Adresse einer von Pepsi kontrollierten SRS_DOMAIN um, sodass die SPF-Prüfung des nächsten Hops besteht. Die Gegenrichtung (das Dekodieren von an eine SRS-Adresse zurückgesendeten Bounces) erledigt pepsi-ingress zur RCPT-Zeit. Beide lesen den gemeinsamen [pepsi-srs]-Abschnitt. Referenz: pepsi-stage-srs(1).

36.2. Funktionen

  • Vorwärts-Umschreibung: MAIL FROM wird zu SRS0=HHHH=TT=domain=local@srs, wobei der ursprüngliche Absender per HMAC signiert und ein taggenauer Zeitstempel aufgeprägt wird; der gekürzte MAC ist base32-kodiert (RFC 4648).

  • Kompakte Neusignierung: Eine Adresse, die bereits SRS ist (die Mail erreichte Pepsi über einen anderen Weiterleiter), wird in der SRS1-Form neu signiert, statt verschachtelt zu werden, sodass ein Bounce einen Weiterleiter nach dem anderen zurückspringt.

  • Idempotent / sicher: Der Null-Absender (ein zurückkehrender Bounce) wird nie umgeschrieben, und ein bereits in SRS_DOMAIN liegender Absender bleibt unverändert.

  • Rückwärts-Dekodierung (in Ingress): Ein Empfänger, der ein gültiges SRS-Token ist, wird verifiziert (Signatur + Zeitstempel) und an den dekodierten ursprünglichen Absender weitergeleitet, auch außerhalb bedienter Domains; ein gefälschtes/abgelaufenes Token wird mit 550 abgelehnt.

  • Weiterleitungs-Rücksendeadresse für weitergeleitete Kopien: Ein Empfänger, den ein Alias oder ein ~/.forward erzeugt hat (state.dsn.rcpt[].expanded_from), geht stattdessen mit fwd+<sealed>=<tag>@srs hinaus, das den ursprünglichen Absender, die vom Absender verwendete Adresse, das Flag für verschlüsselte Ankunft, die Authentifizierung des Absenders und NOTIFY sowie den Tag versiegelt. Ein entfernter Bericht über die Kopie wird dann von pepsi-ingress mit der eigenen DSN dieses Hosts über die vom Absender verwendete Adresse beantwortet, nie weitergeleitet (Weiterleitungsadressen in Zustellberichten). Ein Datensatz, dessen Empfänger unterschiedliche Umschlagabsender brauchen, wird zuerst auf einen Empfänger pro Datensatz aufgeteilt.

  • Nachrichtentext unberührt: Nur der Umschlagabsender ändert sich; DKIM-Body-Hashes bleiben gültig.

  • Betreiberwerkzeuge: Die forward/reverse-Unterbefehle berechnen eine Umschreibung oder dekodieren eine Adresse von Hand.

36.3. Konfiguration

[stage-<name>]: PROGRAM = pepsi-stage-srs und NEXT_STAGE. Die SRS-Parameter werden in [pepsi-srs] geteilt: SRS_DOMAIN, SECRET/SECRET_FILE (der HMAC-Schlüssel; muss stabil und über Instanzen hinweg identisch bleiben), PREVIOUS_SECRET_FILE (ausgemusterte Schlüssel, die zurückkehrende Adressen noch verifizieren, aber nichts signieren, sodass der Schlüssel rotiert werden kann: Rotating the SRS key in Pepsi betreiben), MAX_AGE_DAYS (Gültigkeitsfenster, Standardwert 21) und ALLOW_ALIGNED_DOMAIN. SRS_DOMAIN muss eine dedizierte Domain sein, die mit keiner bedienten Domain DMARC-ausgerichtet ist. Der SPF-Pass, den eine Weiterleitung beim nächsten Hop erhält, gilt für diese Domain. Wäre sie ausgerichtet, bestünde eine gefälschte Nachricht einer bedienten Domain DMARC, sobald sie von hier weitergeleitet wird. pepsi-setup lehnt eine ausgerichtete Domain ab, sofern nicht ALLOW_ALIGNED_DOMAIN = yes (siehe Forwarded forgeries of our own domain in Sicherheitsmodell, zur Wahrung von Ein entfernter Absender); wenn der Assistent einen Server mit postsrsd importiert, wird dessen SRS-Domain zum Standardwert. Das Weglassen von [pepsi-srs] deaktiviert SRS: Der Worker verweigert dann den Start, und der Dispatcher hält seine Nachrichten zurück. Führen Sie die Stage nie in EDITABLE_STAGES auf: Sie schützt den Ruf der Domain, nicht eine Vorliebe eines Benutzers (Adressbezogene Einstellungen sind eine Vertrauensgrenze). Siehe pepsi-stage-srs(1).

36.4. State

  • Eingaben: die Spalte mail_from; state.dsn.rcpt[].expanded_from und .notify, state.crypto.in und der Authentifizierungsdatensatz (state.auth, state.local_origin), die eine Weiterleitungs-Rücksendeadresse versiegelt.

  • Ausgaben: state.srs.original — der Umschlagabsender, wie er vor dem Umschreiben lautete, nur geschrieben, wenn ein Umschreiben stattgefunden hat, und nur, sofern der Schlüssel nicht bereits vorhanden ist (sodass ein zweiter SRS1-Durchgang den frühesten echten Korrespondenten behält). Erzeugt diese Installation eine DSN, adressiert pepsi-stage-bounce sie an diesen Absender statt an unseren eigenen SRS-Alias. Alles Übrige in state, einschließlich state.dsn, bleibt erhalten.

36.5. Siehe auch

pepsi-ingress, pepsi-stage-relay-to-internet, Unterstützte Funktionen, pepsi-stage-srs(1).