95.1.62. pepsi-helper-dot-forward

run a single user’s ~/.forward as that user

Handbuchabschnitt:

1

95.1.62.1.1. Name

pepsi-helper-dot-forward - privilegierter Helper, der das ~/.forward eines lokalen Benutzers verarbeitet, nachdem er zu diesem Benutzer gewechselt ist.

95.1.62.1.2. Übersicht

pepsi-helper-dot-forward TARGET-UID [–pipe] [–file] < message

95.1.62.1.3. Beschreibung

pepsi-helper-dot-forward ist ein minimaler, sicherheitsgehärteter Helper, der genau die ~/.forward-Datei eines lokalen Benutzers ausführt. Er existiert, damit ein vertrauenswürdiger, aber unprivilegierter Aufrufer (ein Mitglied der pepsi-forward-Gruppe, in der Praxis pepsi-stage-dot-forward(1)) das ~/.forward jedes lokalen Benutzers als dieser Benutzer verarbeiten lassen kann und sonst nichts tun kann.

Der Helper wird setuid-root installiert, im Besitz von root:pepsi-forward mit Modus 4750. Nur Mitglieder der pepsi-forward-Gruppe dürfen ihn ausführen; wenn sie es tun, führt der Kernel ihn mit einer effektiven uid von root aus. Mit der numerischen uid des Zielbenutzers als seinem einzigen Positionsargument und der rohen Nachricht auf der Standardeingabe tut der Helper Folgendes:

  1. löst den passwd-Eintrag des Zielbenutzers auf und verweigert uid 0 / das Login root sowie jede uid unterhalb von /etc/login.defs UID_MIN (Standardwert 1000);

  2. wechselt vollständig und unwiderruflich zum Zielbenutzer: Er installiert die ergänzenden Gruppen des Benutzers, dann die gid, dann die uid (real, effektiv und gespeichert), und prüft, dass root nicht wiedererlangt werden kann, wie es pepsi-helper-maildir-writer(1) und pepsi-helper-auto-pay(1) tun. Wenn sich die Gruppen des Benutzers nicht lesen lassen, wird nur die primäre Gruppe behalten;

  3. weigert sich zu handeln (Exit 3), wenn das Heimatverzeichnis oder das ~/.forward selbst nicht der Ziel-uid gehört oder für die Gruppe oder für alle schreibbar ist (mode & 0o022). Das ist die Regel von sendmail/postfix-local: Die Datei nennt |command- und /file-Direktiven, die der Helper als dieser Benutzer ausführt; jeder andere, der in das Verzeichnis schreiben kann, könnte also eine solche Direktive dort ablegen. Beachten Sie, dass der Helper das Heimatverzeichnis prüft, bevor er nach ~/.forward sucht. Auf einem Host mit gruppenschreibbaren Heimatverzeichnissen wird das Konto also selbst dann abgelehnt, wenn es gar kein ~/.forward hat;

  4. wenn der Benutzer keine ~/.forward-Datei hat, beendet er sich mit 1 (die Stage geht dann zu ihrer nächsten Stage über). Eine Datei aus Leerzeilen und Kommentaren erhält dieselbe Antwort, da sie nichts anweist;

  5. andernfalls liest er ~/.forward und handelt an jeder nicht leeren, nicht mit # beginnenden Zeile als der Benutzer: Eine bloße Adresse wird als Weiterleitungsadresse gesammelt, und eine als \name geschriebene Adresse wird mit ihrem Marker gesammelt, was die aufrufende Stage als sendmails „an diesen Namen zustellen und nicht weiter expandieren“ liest; |command leitet die Nachricht an /bin/sh -c command weiter (nur mit –pipe); /absolute/path hängt die Nachricht an diese Datei an (nur mit –file). Eine Direktive, deren Art nicht aktiviert war oder deren Ausführung fehlschlägt, ist ein Fehler. Ein |command wird mit einer von Grund auf neu aufgebauten Umgebung ausgeführt: HOME, USER, LOGNAME und SHELL aus dem passwd-Eintrag des Zielbenutzers (/bin/sh, wenn dessen Shell-Feld leer ist) und PATH auf /usr/local/bin:/usr/bin:/bin gesetzt. Nichts anderes wird gesetzt und nichts vom Aufrufer geerbt, sodass der Zustell-Agent den Befehl nicht über Variablen wie PYTHONPATH, PERL5LIB oder BASH_ENV steuern kann.

Ein |command läuft in seiner eigenen Prozessgruppe und bekommt 300 Sekunden; nach Ablauf erhält die gesamte Gruppe ein SIGKILL (die Gruppe, weil eine Pipe-Direktive routinemäßig forkt), und der Lauf wird als vorübergehender Fehler gemeldet (Exit 3), sodass die Nachricht wiederholt statt gebounct wird. Eine /path-Direktive öffnet das Ziel mit O_NOFOLLOW|O_NONBLOCK und verweigert alles, was keine reguläre Datei ist, sodass eine FIFO oder ein Symlink den Helper nicht unbegrenzt blockieren kann. Ohne diese Grenzen könnte jedes lokale Konto einen Dispatcher-Worker für die Lebensdauer der Pipeline verkeilen, indem es schlicht |sleep infinity in sein ~/.forward schreibt.

Eine Direktive darf in doppelten Anführungszeichen stehen. Diese Form empfiehlt die Dokumentation von procmail und maildrop den Benutzern: "|IFS=' ' && exec /usr/bin/procmail -f- || exit 75 #bob". Eine Zeile darf auch mehrere durch Komma getrennte Einträge tragen. Das erlaubt die Grammatik für die rechte Seite der Alias-Datenbank, die .forward erbt. Eine Lage umgebender doppelter Anführungszeichen wird entfernt, bevor die Direktive klassifiziert wird, und ein Komma innerhalb doppelter Anführungszeichen teilt nicht.

Die Nachricht wird nur dann von der Standardeingabe gelesen, wenn eine |pipe//file-Direktive, die sie verbraucht, laufen darf (d. h. wenn –pipe oder –file angegeben ist).

95.1.62.1.4. Argumente

TARGET-UID

Die numerische Benutzer-ID, deren ~/.forward verarbeitet wird. Sie muss einen passwd-Eintrag haben; uid 0 / das root-Konto sowie jede uid unterhalb von /etc/login.defs UID_MIN werden verweigert.

–pipe

Erlaubt |command-Direktiven (die Stage übergibt dies, wenn ihr ALLOW_PIPE aktiv ist).

–file

Erlaubt /path-Datei-Anhänge-Direktiven (die Stage übergibt dies, wenn ihr ALLOW_FILE aktiv ist).

95.1.62.1.5. Exit-Status

0

Das ~/.forward wurde erfolgreich verarbeitet. Die von ihm benannten Weiterleitungsadressen werden eine pro Zeile auf die Standardausgabe geschrieben.

1

Der Benutzer hat kein ~/.forward oder eines, das nur Leerzeilen und Kommentare enthält. Der Aufrufer geht zu seiner nächsten Stage über.

2

Die Verarbeitung schlug fehl: Ein Pipe-Befehl beendete sich mit einem Wert ungleich null (außer 75) oder wurde durch ein Signal beendet, eine Datei konnte nicht geschrieben werden, eine deaktivierte Direktive wurde angefordert, oder das ~/.forward nennt mehr als 100 Adressen. Eine menschenlesbare Diagnose wird zur Aufnahme in den Bounce auf die Standardausgabe geschrieben. Dies ist ein dauerhafter Fehler dieses Empfängers.

3

Ein betrieblicher Fehler des Hosts, nicht der Zustellung: Der Helper ist nicht setuid-root installiert, die Ziel-uid hat keinen passwd-Eintrag oder die passwd-Abfrage selbst schlug fehl (ein NSS-/LDAP-Ausfall), das Konto ist root oder liegt unter UID_MIN, das Heimatverzeichnis ist nicht absolut, oder das Heimatverzeichnis oder das ~/.forward selbst gehört nicht ausschließlich dem Zielbenutzer (es gehört ihm nicht oder ist für die Gruppe oder für alle schreibbar). Die Diagnose geht sowohl auf die Standardausgabe als auch auf die Standardfehlerausgabe. Der Aufrufer muss dies als wiederholbar behandeln: Die Nachricht bleibt in der Warteschlange und erzeugt keinen Bounce für einen Zustand, den der Betreiber beheben kann.

Der Fall des unsicheren Heimatverzeichnisses ist eine Eigenschaft des Kontos, nicht der Nachricht: mit chmod 0775 ~alice endet jede Nachricht an alice hier und bleibt in der Warteschlange, und keine davon erreicht die lokale Zustellung. chmod g-w,o-w auf dem Heimatverzeichnis (und auf ~/.forward) behebt das.

Ein |command, das darum bittet, erneut versucht zu werden, endet ebenfalls mit 3: eines, das mit 75 endet (EX_TEMPFAIL, was procmail und maildrop für ein gesperrtes Postfach oder eine volle Platte melden), eines, das über das Limit von 300 Sekunden hinaus läuft, und eines, das gar nicht gestartet werden kann. Die eigene Diagnose des Befehls geht auf beide Ausgabeströme. Direktiven weiter vorn in der Datei haben dann bereits gewirkt und wirken bei der Wiederholung erneut, wie unter jedem Zustellagenten, der mitten in einer .forward aufschiebt.

4

|command- oder /file-Direktiven haben die Nachricht übernommen, und das ~/.forward nennt keine Adresse. Für diesen Empfänger ist nichts mehr zuzustellen.

Wenn es von einem Benutzer aufgerufen wird, der kein Mitglied der pepsi-forward-Gruppe ist, weigert sich der Kernel, das Binärprogramm überhaupt auszuführen; der Helper selbst läuft nie.

95.1.62.1.6. Sicherheit

Die Mitgliedschaft in der pepsi-forward-Gruppe ist die Schranke der Zugriffskontrolle. Der Helper führt beliebige Befehle aus und schreibt beliebige Dateien nur als der unprivilegierte Zielbenutzer, niemals als root: Er gibt Privilegien vollständig ab, bevor er das ~/.forward liest oder eine der Dateien des Benutzers berührt, und weigert sich, für das root-Konto zu handeln. Nur die ersten 64 KiB von ~/.forward werden gelesen.

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

95.1.62.1.7. Siehe auch

pepsi-stage-dot-forward(1), pepsi-helper-maildir-writer(1), pepsi-dispatch(1), pepsi.conf(5)

95.1.62.1.8. Fehler

Melden Sie Fehler an den Pepsi-Issue-Tracker.