45. pepsi-stage-dot-forward

Verarbeitet benutzerspezifische ~/.forward-Dateien.

45.1. Rolle

pepsi-stage-dot-forward lässt einen lokalen Kontoinhaber seine eigene Mail mit einer ~/.forward-Datei umleiten. Für jeden Umschlagempfänger, der lokal ist (dieselbe LOCAL_DOMAINS / TARGETS / RECIPIENT_DELIMITER-Prüfung wie pepsi-stage-relay-to-maildir), führt sie das ~/.forward dieses Benutzers über den setuid-root pepsi-helper-dot-forward(1)-Helper aus, der zuerst zum Benutzer wechselt. Nicht lokale Empfänger bleiben unberührt. Die Stage steht normalerweise direkt vor der lokalen Zustellung. Referenz: pepsi-stage-dot-forward(1).

45.2. Funktionen

45.2.1. Ergebnisse pro Empfänger

  • Kein ~/.forward — der Empfänger ist eine Durchleitung und schaltet zu NEXT_STAGE weiter (typischerweise lokale Zustellung).

  • Weitergeleitet — der Empfänger wird durch die Adressen ersetzt, die das ~/.forward nennt; diese starten die Pipeline bei RESTART_STAGE (Standardwert init) neu, sodass sie wie frische Mail neu authentifiziert und neu geroutet werden, nach einem zufälligen Zurückhalten von bis zu [pepsi] REFLECTION_HOLD_MAX (30 s), da eine weitergeleitete Kopie reflektierte Mail ist (Unbekannte Empfänger und Backscatter). Ein leeres Ergebnis (die Nachricht wurde von einer |pipe//file-Direktive verbraucht) lässt den Empfänger fallen.

  • Fehlgeschlagen — der Empfänger wird zu BOUNCE_STAGE geroutet, wenn sein ~/.forward fehlschlägt: ein Pipe-Befehlsfehler, ein Dateischreibfehler, eine deaktivierte Direktive, mehr als 100 Adressen oder eine Adresse, die die Stage als unbrauchbar ablehnt (über 256 Oktette, Leerraum, Steuerzeichen, < > " , ; oder eine ungültige Domain).

  • Host-Problem — der Helfer konnte überhaupt nicht handeln (nicht setuid-root installiert, ein Fehler bei der passwd-Abfrage, ein Home-Verzeichnis oder eine ~/.forward, die nicht ausschließlich dem Benutzer gehört), oder ein |command bat um einen erneuten Versuch (Exit 75, EX_TEMPFAIL) oder überschritt seine 300 Sekunden. Nichts wird gebounct: Die Nachricht bleibt in der Warteschlange und wird bis MAX_LIFETIME wiederholt, und die in diesem Durchlauf bereits verarbeiteten Empfänger werden zuerst festgeschrieben, sodass kein ~/.forward für sie zweimal läuft.

Eine Nachricht mit mehreren Empfängern kann diese mischen; die weitergeleiteten Adressen, die Bounces je Empfänger und die behaltenen Empfänger werden in einer Aufteilung der Nachricht, gefolgt von ihrem Abschluss, abgeglichen (eine einzige Anweisung, wenn kein Empfänger auf der Nachricht verbleibt).

45.2.2. ~/.forward-Direktiven

Der Helper handelt an jedem Eintrag als der Benutzer. Er überspringt leere und #-Zeilen, und eine Zeile kann mehrere kommagetrennte, optional in doppelte Anführungszeichen gesetzte Einträge enthalten. Eine bloße Adresse wird zu einer Weiterleitungsadresse. |command leitet die Nachricht per Pipe an /bin/sh -c, wenn ALLOW_PIPE an ist, mit einer Umgebung, die nur aus dem passwd-Eintrag des Benutzers und einem festen PATH aufgebaut ist. /absolute/path hängt die Nachricht an eine Datei an, wenn ALLOW_FILE an ist. Wenn sowohl ALLOW_PIPE als auch ALLOW_FILE aus sind, wird der Nachrichtentext dem Helper nicht einmal übergeben.

Eine mit sendmails führendem \ geschriebene Adresse bedeutet „an diesen Namen zustellen und ihn nicht weiter expandieren“ und wird nicht bei RESTART_STAGE neu gestartet. Die kanonische Zeile, um eine lokale Kopie zu behalten, \bob in ~bob/.forward, hält diesen Umschlagempfänger schlicht auf diesem Datensatz, sodass er zu NEXT_STAGE weiterrückt und lokal zugestellt wird; jedes andere \name wird zu einem Geschwisterdatensatz bei NEXT_STAGE. Das ist zugleich, was einen \-Eintrag daran hindert, diese Stage erneut zu betreten.

45.2.3. Schleifenverhinderung

Weil eine Weiterleitung die Pipeline neu startet, trägt jeder weitergeleitete Datensatz seine Weiterleitungskette in state["dot-forwarders"] (siehe Der Nachrichten-State): die Kette des Datensatzes, aus dem er stammt, plus den Login, dessen ~/.forward ihn weitergeleitet hat. Ein Empfänger, dessen Benutzer bereits in der Kette seines Datensatzes steht, wird an BOUNCE_STAGE geroutet, ohne seine ~/.forward erneut auszuführen (eine Nachricht mit Null-Absender wird stattdessen verworfen), sodass ein Weiterleitungszyklus endet und der Absender davon erfährt. Die Kette gilt je Weiterleitungspfad: Mehrere weiterleitende Empfänger einer Nachricht erhalten jeweils einen Geschwisterdatensatz, der nur ihre eigene Kette trägt.

45.2.4. Wiederverwendete Adressen

Ein lokaler Empfänger, dessen RRVS=-Parameter oder Require-Recipient-Valid-Since-Feld ein Datum vor einem festgehaltenen Inhaberwechsel seines Logins nennt, wird mit 550 5.7.17 gebounct, bevor der Helper läuft, sodass das ~/.forward eines neuen Inhabers die Nachricht nicht wegtragen kann (Ein Login, das den Eigentümer wechselt). Weitergeleitete Adressen erben die Anforderung nicht.

45.3. Privilegien

Die Stage muss setgid pepsi-forward installiert sein, mit Modus 2550 und Eigentümer pepsi:pepsi-forward. Nur der Eigentümer darf sie ausführen, sodass kein anderer lokaler Benutzer an das setgid-Bit gelangt. Diese Gruppenmitgliedschaft erlaubt es dem pepsi-Worker des Dispatchers, den 4750 root:pepsi-forward-Helper auszuführen. Nur der Helper führt das ~/.forward als der Zielbenutzer aus, und er weigert sich, für root oder eine uid unter UID_MIN zu handeln. Die Stage setzt die Regel auch selbst durch: Mit dem setgid-Bit laufend, lehnt sie einen realen Benutzer außer root oder pepsi ab, bevor sie irgendeine Konfiguration liest. Der Helper lehnt ein Home-Verzeichnis oder ~/.forward ab, das nicht ausschließlich dem Benutzer gehört (ein Host-Problem, die Nachricht wartet also), öffnet ~/.forward, ohne Symlinks zu folgen, und führt ein |command in seiner eigenen Prozessgruppe mit einer nur aus dem passwd-Eintrag des Benutzers aufgebauten Umgebung aus; ein Befehl bekommt 300 Sekunden und der Helper insgesamt 330, bevor er beendet und wiederholt wird. Siehe Die Privilegientrennung und Ein lokaler Shell-Benutzer. Dieses Bit zu tragen ist der Grund, warum die Stage ein eigenständiges Binärprogramm ist statt eines der Programme, die in das vereinheitlichte pepsi-Binärprogramm gefaltet sind.

45.4. Konfiguration

[stage-<name>]: PROGRAM = pepsi-stage-dot-forward, NEXT_STAGE (wohin ein durchgereichter Empfänger geht — normalerweise die lokale Zustellung), BOUNCE_STAGE (wohin ein fehlgeschlagener ~/.forward-Empfänger geht), RESTART_STAGE (Standardwert init), ALLOW_PIPE und ALLOW_FILE (beide standardmäßig yes), HELPER (Standardwert pepsi-helper-dot-forward) und die gemeinsamen Lokalitätsoptionen LOCAL_DOMAINS (standardmäßig [pepsi-ingress] ACCEPTED_DOMAINS), TARGETS und RECIPIENT_DELIMITER. pepsi-setup prüft, dass RESTART_STAGE eine echte Stage benennt. Siehe pepsi-stage-dot-forward(1).

45.5. State

  • Eingaben: state["dot-forwarders"] (der Schleifenschutz) und state.dsn.

  • Ausgaben: state["dot-forwarders"] auf jedem weitergeleiteten Datensatz (neu gestartet oder \name): die Kette des Quelldatensatzes plus das Login, dessen ~/.forward ihn erzeugt hat. state.dsn.rcpt wird im Gleichschritt mit den Empfängern jedes Datensatzes neu aufgebaut, und jedes Weiterleitungsziel wird mit expanded_from markiert (dem Empfänger, den es ersetzt). Eine DSN über ein Ziel nennt daher nur diesen Empfänger (pepsi-stage-bounce), und eine Kopie, die die Site verlässt, geht mit einer Weiterleitungs-Rücksendeadresse hinaus (pepsi-stage-srs, Weiterleitungsadressen in Zustellberichten). So wird ein Bericht vom eigenen Server des Ziels auf dieselbe Weise beantwortet statt weitergeleitet. Der Datensatz eines gebouncten Empfängers trägt state.bounce.

45.6. Siehe auch

pepsi-stage-relay-to-maildir, pepsi-stage-aliases, pepsi-stage-bounce, Unterstützte Funktionen, pepsi-stage-dot-forward(1), pepsi-helper-dot-forward(1).