95.1.14. pepsi-stage-dot-forward

process per-user ~/.forward files

Handbuchabschnitt:

1

95.1.14.1.1. Name

pepsi-stage-dot-forward - die ~/.forward-Verarbeitungs-Stage der Pepsi-Pipeline.

95.1.14.1.2. Übersicht

pepsi-stage-dot-forward [GLOBAL-OPTIONS] worker

95.1.14.1.3. Beschreibung

pepsi-stage-dot-forward ist ein Stage-Programm, das von pepsi-dispatch(1) ausgeführt wird. Für jeden Umschlagempfänger, der auf ein lokales Konto auflöst, führt es die ~/.forward-Datei dieses Benutzers aus, den klassischen sendmail/Postfix-Mechanismus, mit dem ein Kontoinhaber seine eigene Mail umleitet. Die Lokalität wird genau wie in pepsi-stage-relay-to-maildir(1) entschieden: Die Domain des Empfängers muss in LOCAL_DOMAINS stehen, sein Postfachname (Local-Part, Subadresse nach RECIPIENT_DELIMITER entfernt, kleingeschrieben) muss auf einen passwd-Eintrag auflösen, und diese uid muss durch TARGETS erlaubt sein. Ein Empfänger, der nicht lokal ist, bleibt unberührt und schaltet zu NEXT_STAGE weiter. Eine passwd-Abfrage, die fehlschlägt (ein LDAP- oder sssd-Backend, das nicht läuft), wird nicht als „nicht lokal“ gewertet: Die Nachricht wird erneut versucht, statt am ~/.forward des Benutzers vorbei zugestellt zu werden.

Das ~/.forward selbst wird von dem privilegierten Helper pepsi-helper-dot-forward(1) gelesen und ausgeführt, der zuvor seine Privilegien auf den Zielbenutzer absenkt. Der Exit-Status des Helpers teilt der Stage mit, was aus diesem Empfänger wurde:

  • kein ~/.forward — der Empfänger ist eine Durchleitung: Er bleibt auf der Nachricht, die zu NEXT_STAGE weiterschaltet (typischerweise lokale Zustellung, dann ein Smarthost). Ein leeres ~/.forward oder eines, das nur Leerzeilen und Kommentare enthält, weist nichts an und zählt als keines. Ein Empfänger, der durch seinen eigenen \name-Eintrag behalten wird, schaltet ebenfalls zu NEXT_STAGE weiter, aber, wann immer die Nachricht aufgeteilt wird, auf einem eigenen Geschwisterdatensatz, sodass keine Wiederholung dieser Stage sein ~/.forward ein zweites Mal ausführt.

  • weitergeleitet — der Empfänger wird durch die Adressen ersetzt, die das ~/.forward nennt. Diese starten die Pipeline bei RESTART_STAGE (Standardwert init) auf einem neuen Geschwister-Datensatz neu, sodass die umgeschriebenen Empfänger wie frische Mail neu authentifiziert und neu geroutet werden. Jede Adresse hält den Empfänger fest, den sie ersetzt (expanded_from in ihrem state.dsn-Eintrag, neben einem ORCPT, das ihn nennt). Eine DSN, die Pepsi darüber schreibt, nennt daher nur diesen Empfänger, mit einer generischen Diagnose (pepsi-stage-bounce(1)): Die Ziele eines ~/.forward werden dem Absender nicht offengelegt. Eine Kopie, die die Site verlässt, geht mit einer Weiterleitungs-Rücksendeadresse (pepsi-stage-srs(1)) statt einer SRS-Adresse hinaus. Ein Bericht, den der eigene Server des Ziels sendet, kommt so zu pepsi-ingress(1) zurück, das ihn mit derselben Art von DSN beantwortet und nicht weiterreicht. Der Datensatz beginnt paused für eine zufällige Zeit von bis zu [pepsi] REFLECTION_HOLD_MAX (Standardwert 30 s; pepsi.conf(5)), da eine weitergeleitete Kopie reflektierte Mail ist; danach gibt der Dispatcher ihn frei.

  • verbraucht — |pipe- oder /file-Direktiven haben die Nachricht übernommen, und das ~/.forward nennt keine Adresse (Exit 4). Der Empfänger hat seine Mail und verlässt die Nachricht.

  • fehlgeschlagen — der Helper hat sich für diesen Empfänger verweigert oder ist gescheitert (Exit 2): Ein Pipe-Befehl beendete sich mit einem Wert ungleich null (außer 75), eine Datei konnte nicht geschrieben werden, eine deaktivierte Direktive wurde angefordert, oder das ~/.forward nennt mehr als 100 Adressen; oder die Stage hat eine Adresse abgelehnt, die der Helper zurückgegeben hat (eine, die länger als 256 Oktette ist, Leerraum, ein Steuerzeichen oder eines von < > " , ; enthält oder eine ungültige Domain hat). Der Empfänger wird zu BOUNCE_STAGE geroutet, damit eine Failure-DSN erzeugt wird (unter Beachtung des NOTIFY des Absenders). Für eine Nachricht, die selbst ein Bounce ist (Null-Absender), wird nie erneut ein Bounce erzeugt.

  • Host-Problem — der Helper meldete einen betrieblichen Fehler (Exit 3), ein |command bat darum, erneut versucht zu werden, oder der Helper konnte gar nicht ausgeführt werden, wurde durch ein Signal beendet oder endete mit einem Status, den er nicht dokumentiert. Ein betrieblicher Fehler bedeutet: Der Helper ist nicht setuid-root installiert, die passwd-Abfrage schlug fehl, das Konto wird abgelehnt (root, eine uid unter UID_MIN, ein relatives Heimatverzeichnis), das Heimatverzeichnis oder das ~/.forward gehört nicht ausschließlich dem Benutzer (es gehört ihm nicht oder ist für die Gruppe oder für alle schreibbar), oder das ~/.forward ist ein symbolischer Link, keine reguläre Datei oder nicht lesbar. Der Helper prüft das Heimatverzeichnis, bevor er nach einem ~/.forward sucht, sodass dies auch Konten abweist, die keines haben. Ein |command bittet um einen erneuten Versuch, wenn es mit 75 (EX_TEMPFAIL) endet, seine Zeit überschreitet oder nicht gestartet werden kann. Nichts davon ist ein Urteil über den Empfänger, also wird kein Bounce erzeugt: Die Nachricht wird erneut versucht (eine Minute, verdoppelt bis zu einer Stunde, bis MAX_LIFETIME, wonach sie zu BOUNCE_STAGE geht oder, wenn es keines gibt, fehlschlägt; siehe pepsi-dispatch(1)).

    Die früher im selben Durchlauf verarbeiteten Empfänger sind erledigt: Ihre Pipes sind gelaufen und ihre Dateien geschrieben. Vor der Wiederholung werden sie daher mit ihrem Ergebnis (weitergeleitet, behalten, gebounct) committet, und die Nachricht wird auf die Empfänger reduziert, die der Helper nicht erreicht hat. Eine Wiederholung führt das ~/.forward eines Empfängers daher nie zweimal aus. Die einzige Ausnahme ist der Empfänger, dessen eigenes ~/.forward mittendrin aufgeschoben hat: Direktiven oberhalb derjenigen, die aufgeschoben hat, haben gewirkt und wirken erneut.

Eine einzelne Nachricht kann eine Mischung dieser Ergebnisse über ihre Empfänger hinweg haben; die weitergeleiteten Adressen, die Bounces je Empfänger und die behaltenen (durchgeleiteten) Empfänger werden in einer einzigen Aufteilung der Nachricht abgeglichen, gefolgt von ihrem Terminal (in derselben Anweisung, wenn kein Empfänger auf der Nachricht verbleibt). Das Token jedes Geschwisterdatensatzes wird aus dem Empfänger oder dem weiterleitenden Login abgeleitet, den er trägt, sodass ein wiederholter Durchlauf nie mit einem kollidieren kann, den ein früherer Durchlauf erzeugt hat.

95.1.14.1.4. Weiterleitungsschleifen

Weil eine weitergeleitete Nachricht die gesamte Pipeline neu startet, würden zwei Benutzer, die einander weiterleiten (~bob → alice, ~alice → bob), in eine Schleife geraten. Um dies zu verhindern, trägt jeder weitergeleitete Datensatz seine Weiterleitungskette in state["dot-forwarders"] (siehe pepsi.state(7)): die Kette des Datensatzes, von dem er weitergeleitet wurde, plus das Login, dessen ~/.forward ihn weitergeleitet hat. Ein Empfänger, dessen Benutzer bereits in der Kette seines Datensatzes steht, wird nicht zugestellt, und der Helper wird nicht aufgerufen (eine Warnung wird protokolliert), sodass die Kette terminiert. Der Empfänger wird wie bei jedem anderen ~/.forward-Fehler zu BOUNCE_STAGE geroutet, sodass der Absender es erfährt (RFC 5321 §6.1 verlangt eine Benachrichtigung, sobald die Nachricht angenommen wurde). Ist die Nachricht selbst ein Bounce, wird der Empfänger stattdessen fallen gelassen.

Die Kette gehört zu einem Weiterleitungspfad, nicht zur Nachricht: Wenn mehrere Empfänger einer Nachricht weiterleiten, gehen die Adressen jedes einzelnen auf einem eigenen Geschwister-Datensatz hinaus, der nur die Kette dieses Empfängers trägt. Ein späterer Hop über das ~/.forward eines Empfängers wird daher nie wegen des Eintrags eines anderen Empfängers in der Kette für eine Schleife gehalten. Eine Adresse, an die mehrere von ihnen weiterleiten, wird einmal zugestellt, auf dem Datensatz des ersten Empfängers, der sie genannt hat.

95.1.14.1.5. Wiederverwendete Adressen (RFC 7293)

Ein ~/.forward ist die eigene Umleitung seines Inhabers. Nach RFC 7293 Abschnitt 5.2.1 besteht es den Test der durchgehenden Inhaberschaft nur für den Inhaber, den der Absender meinte. Ein lokaler Empfänger kann eine Anforderung tragen, dass die Inhaberschaft seit einem bestimmten Datum besteht (ein RRVS=-Parameter oder ein Require-Recipient-Valid-Since-Header-Feld, das den Empfänger nennt; siehe pepsi-stage-relay-to-maildir(1)). Hat das Login des Empfängers nach diesem Datum einen festgehaltenen Inhaberwechsel, wird für den Empfänger daher mit 550 5.7.17 über BOUNCE_STAGE ein Bounce erzeugt, bevor der Helper läuft. So kann die Weiterleitung des neuen Inhabers die Nachricht nicht wegtragen. Für einen solchen Empfänger hält die Prüfung die aktuelle uid des Logins in pepsi.login_assignment fest, wie es die lokale Zustellung tut (ein Empfänger ohne Anforderung wird hier nicht festgehalten); ein Datenbankfehler wiederholt den Empfänger. Weitergeleitete Adressen erben die Anforderung nicht (RFC 7293 Abschnitt 8.2: Pepsi hält keinen Inhaberschaftsdatensatz für das neue Ziel).

95.1.14.1.6. Argumente und Unterbefehle

worker

Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest und je eine Statuszeile schreibt. So führt der Dispatcher die Stage im Produktivbetrieb aus.

95.1.14.1.7. Konfiguration

Aus dem [stage-<stage>]-Abschnitt der Nachricht gelesen:

PROGRAM

Muss pepsi-stage-dot-forward sein.

RESTART_STAGE

Die Stage, bei der eine erfolgreich weitergeleitete Nachricht neu startet. Standardwert ist init (führt die gesamte eingehende Pipeline erneut aus, einschließlich Authentifizierung). Setzen Sie sie auf eine spätere Stage (z. B. srs), um die erneute Authentifizierung einer intern weitergeleiteten Nachricht zu überspringen. Muss eine existierende Stage benennen.

ALLOW_PIPE

Ob |command-Direktiven in einem ~/.forward beachtet werden (die Nachricht wird an den Befehl geleitet, der als der Benutzer ausgeführt wird). Standardwert ist yes.

ALLOW_FILE

Ob /path-Direktiven (die Nachricht an eine Datei anhängen) beachtet werden. Standardwert ist yes. Sind sowohl ALLOW_PIPE als auch ALLOW_FILE no, leitet die Stage den Nachrichtentext überhaupt nicht an den Helper weiter (der Helper muss nur Weiterleitungsadressen lesen).

TARGETS, LOCAL_DOMAINS, RECIPIENT_DELIMITER

Die Auswahl lokaler Konten, in der Bedeutung identisch mit pepsi-stage-relay-to-maildir(1). Standardwert von TARGETS ist der reguläre (Nicht-System-)uid-Bereich aus /etc/login.defs, und pepsi-helper-dot-forward(1) lehnt jede uid unter UID_MIN ab, was auch immer dort steht (pepsi-setup(1) warnt vor einem Token, das darunter reicht); Standardwert von LOCAL_DOMAINS ist [pepsi-ingress] ACCEPTED_DOMAINS; Standardwert von RECIPIENT_DELIMITER ist [pepsi] RECIPIENT_DELIMITER und, falls dieses fehlt, + (none schaltet das Entfernen der Subadresse ab).

HELPER

Der auszuführende privilegierte ~/.forward-Helper. Standardwert ist pepsi-helper-dot-forward (auf $PATH aufgelöst); setzen Sie einen absoluten Pfad, um ihn zu überschreiben.

NEXT_STAGE

Wohin durchgeleitete Empfänger (kein ~/.forward) weiterschalten. Erforderlich, da die meisten Empfänger kein ~/.forward haben. Die Stage wird normalerweise direkt vor der lokalen Zustellung platziert, sodass NEXT_STAGE die Lokale-Zustellung-Stage ist.

BOUNCE_STAGE

Die Stage, die DSNs erzeugt. Ein Empfänger wird dorthin geroutet, wenn das Ausführen seines ~/.forward fehlschlägt. Ohne sie bleibt dieser Empfänger auf einer Zeile mit dem Status failed, mit der Diagnose in state.last_error, damit pepsi-failure-bouncer(1) oder ein Betreiber ihn findet.

95.1.14.1.8. Eine ~/.forward-Datei

Der Helper liest höchstens die ersten 64 KiB des ~/.forward des Benutzers. Leere Zeilen und Zeilen, die mit # beginnen, werden übersprungen; eine Zeile kann mehrere durch Kommas getrennte Einträge enthalten, und ein Eintrag kann in doppelte Anführungszeichen eingeschlossen sein (ein Komma innerhalb der Anführungszeichen trennt nicht), wie im dokumentierten "|exec /usr/bin/procmail" von procmail. Jeder Eintrag ist eines von:

  • eine E-Mail-Adresse — wird gesammelt und als neuer Empfänger verwendet. Ein bloßer Name wie alice bezeichnet dieses Konto an dieser Site: Er wird mit der Domain des Empfängers ergänzt, sodass alice in einer Mail an bob@example.com zu alice@example.com wird;

  • \name — sendmails Markierung „an name zustellen und nicht weiter expandieren“. Die Adresse wird nicht bei RESTART_STAGE neu gestartet: Benennt sie das eigene Konto des Empfängers (das kanonische \bob in ~bob/.forward, womit ein Benutzer eine lokale Kopie behält und zugleich weiterleitet), bleibt dieser Empfänger einfach auf der Nachricht und schaltet zu NEXT_STAGE weiter. Jedes andere \name wird zu einem Geschwister-Datensatz bei NEXT_STAGE; ein bloßer Name wird mit der Domain des Empfängers qualifiziert. Weil ein solcher Empfänger diese Stage nie erneut betritt, kann die Markierung keine unbegrenzte Schleife erzeugen. Beachten Sie, dass sie auch das eigene ~/.forward jenes Benutzers umgeht, was „nicht weiter expandieren“ bedeutet;

  • |command — wenn ALLOW_PIPE eingeschaltet ist, wird die Nachricht per Pipe an /bin/sh -c command übergeben, ausgeführt als der Benutzer, in einer eigenen Prozessgruppe und mit einer von Grund auf neu aufgebauten Umgebung: HOME, USER, LOGNAME und SHELL aus dem passwd-Eintrag des Benutzers und PATH fest auf /usr/local/bin:/usr/bin:/bin; nichts wird von der Stage geerbt;

  • /absolute/path — ist ALLOW_FILE eingeschaltet, wird die Nachricht als der Benutzer an diese Datei angehängt (im mbox-Stil).

Ein bloßer Name startet wie jede andere Adresse bei RESTART_STAGE neu, sodass der eigene Name des Empfängers als Weiterleitungsschleife zu dieser Stage zurückkommt und gebounct wird. Um eine lokale Kopie zu behalten, schreiben Sie \name.

Ein |command bekommt 300 Sekunden, um fertig zu werden; danach wird seine gesamte Prozessgruppe abgeschossen und der Empfänger wie bei einem Befehl, der mit 75 endete, erneut versucht (ein langsamer Zustellagent sagt nichts über den Empfänger aus, und ihn zu bouncen würde Mail verwerfen, die eine Minute später angenommen worden wäre). Die Stage ihrerseits gibt einen Helper auf und schießt ihn ab, wenn er nach 330 Sekunden nicht fertig ist, und meldet das als wiederholbaren Fehler statt als Bounce. Beide Grenzen sind fest einkompilierte Konstanten, keine Konfiguration. Sie sorgen dafür, dass das |sleep infinity eines einzigen Kontos oder eine Datei-Direktive, die ein FIFO benennt, keinen Dispatcher-Worker dauerhaft belegen kann und dass PARALLELISM solcher Konten die Stage nicht zum Stillstand bringen. Eine Datei-Direktive muss eine reguläre Datei benennen; ein FIFO, ein Gerät oder ein Symlink wird abgelehnt.

95.1.14.1.9. Installation und Privilegien

Um den setuid-root-Helper zu erreichen, muss pepsi-stage-dot-forward selbst set-group-id auf die Gruppe pepsi-forward installiert sein, mit Modus 2550 und Eigentümer pepsi:pepsi-forward. Der Modus erlaubt die Ausführung dem Eigentümer und nicht allen, denn das setgid-Bit ist die Schranke vor dem setuid-root-Helper. Das Ausführungsrecht kann auch nicht aus den Gruppenbits kommen, da pepsi bewusst kein Mitglied der Gruppe ist; es kommt daher vom Eigentümer. pepsi-dispatch(1) führt die Stage als unprivilegierten Dienstbenutzer pepsi aus. Das setgid-Bit gibt dem Worker eine effektive gid von pepsi-forward, und genau das erlaubt ihm, den gruppenbeschränkten pepsi-helper-dot-forward(1) auszuführen; nichts anderes auf dem Host erlangt diese Fähigkeit. make install richtet dies ein (mit seinem Schritt install-forward-stage), sofern es als root ausgeführt wird und die Gruppe pepsi-forward existiert; andernfalls gibt es die genauen, von Hand auszuführenden Befehle aus.

Da das setgid-Bit diese Schranke ist, setzt das Programm dieselbe Regel selbst durch. Läuft es mit diesem Bit und ist der reale Benutzer weder root noch das Dienstkonto pepsi, beendet es sich mit einem Fehler, bevor irgendeine Konfiguration gelesen wird. Wie die setuid-Krypto-Stages entfernt es außerdem die Umgebungsvariablen, die das Laden der Konfiguration steuern (HOME, XDG_CONFIG_HOME, PG*, TALER_*, PEPSI_*), und legt PATH auf einen sicheren Standardwert fest. Der Dateimodus gehört zur Installation und diese Prüfung zum Programm, sodass keines von beiden den Schutz allein leisten muss.

Das Kapitel Sicherheit des Pepsi-Handbuchs führt jedes Programm auf, das ein setuid- oder setgid-Bit trägt, und warum; sein Kapitel Bedrohungsmodell legt dar, was ein lokales Konto über sie erlangen kann und was nicht.

95.1.14.1.10. Siehe auch

pepsi-helper-dot-forward(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-aliases(1), pepsi-stage-bounce(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7)

95.1.14.1.11. Fehler

Melden Sie Fehler an den Pepsi-Issue-Tracker.