44. pepsi-stage-relay-to-maildir

Stellt in die Maildirs lokaler Benutzer zu; leitet den Rest weiter.

44.1. Rolle

pepsi-stage-relay-to-maildir ist die Stage für die lokale Zustellung. Für jeden Umschlagempfänger entscheidet sie, ob die Adresse lokal ist, und schreibt die Nachricht, falls ja, über den setuid-root pepsi-helper-maildir-writer(1)-Helper in das Maildir/new/ dieses Benutzers; jeder andere Empfänger wird zu NEXT_STAGE weitergeleitet. Referenz: pepsi-stage-relay-to-maildir(1).

44.2. Funktionen

44.2.1. Abgleich lokaler Empfänger

  • Ein Empfänger ist lokal, wenn seine Domain in LOCAL_DOMAINS ist (Standardwert [pepsi-ingress] ACCEPTED_DOMAINS), sein Postfachname auf einen passwd-Eintrag auflöst und diese uid durch TARGETS erlaubt ist.

  • TARGETS ist eine Positivliste von Benutzernamen, uids und uid-Bereichen (alice, 452, 1000-1100, 10000-); der Standardwert ist der reguläre (Nicht-System-)uid-Bereich aus /etc/login.defs. Der Helfer lehnt jede uid unterhalb von UID_MIN ohnehin ab, sodass ein hier aufgeführtes Systemkonto gebounct wird.

  • Der Postfachname ist der Local-Part mit entfernter RECIPIENT_DELIMITER-Subadresse (Standardwert +), kleingeschrieben.

44.2.2. Teilzustellung

  • Lokale Empfänger werden in ihre Maildirs geschrieben; die übrigen Empfänger werden auf einen neuen pending-Datensatz aufgeteilt, und wohin, hängt davon ab, warum sie nicht lokal sind. Ein Empfänger an der Domain eines anderen ist eine Weiterleitung und geht zu NEXT_STAGE, das den SRS-Relay-Schwanz erreichen sollte. Ein Empfänger an einer unserer LOCAL_DOMAINS, der sich zu keinem zugelassenen Konto auflöst, ist ein unbekanntes Postfach und geht zu UNKNOWN_MAILBOX_STAGE, das zu einem Bounce führen sollte. Würde man ihn stattdessen relayen, schlüge das unseren eigenen MX nach, fände diesen Host und schickte die Nachricht an uns selbst zurück. UNKNOWN_MAILBOX_STAGE fällt standardmäßig auf NEXT_STAGE zurück.

  • Zwei Adressen für dasselbe lokale Konto werden nur einmal zugestellt.

  • Eine passwd-Abfrage, die fehlschlägt (ein Verzeichnis-Backend, das nicht erreichbar ist), wiederholt die ganze Nachricht, bevor irgendetwas zugestellt wird; sie wird nie als „kein solcher Benutzer“ gewertet.

  • Jeder lokalen Kopie werden ein Return-Path:, ein Delivered-To:-Schleifenschutz und ein Received:-Trace-Header vorangestellt.

44.2.3. Wiederholung, Bounce und DSN

  • Der Exit-Code des Helfers entscheidet, ob eine Wiederholung helfen kann. Ein vorübergehender Fehler (eine volle Platte, ein E/A-Fehler, ein noch nicht setuid installierter Helfer, eine fehlschlagende passwd-Abfrage, ein Helfer, der überhaupt nicht ausgeführt werden konnte) pausiert diesen Empfänger mit exponentiellem Backoff bis MAX_LIFETIME und routet ihn erst dann zu BOUNCE_STAGE. Ein dauerhafter Fehler wird sofort gebounct, da keine Wiederholung die Nachricht zustellen kann: Das Postfach selbst ist unbrauchbar (falsche Eigentümerschaft oder Rechte, kein Heimatverzeichnis, eine uid unter UID_MIN). Ein Bounce wird nie erneut gebounct, eine Stage ohne BOUNCE_STAGE verwirft den Empfänger mit einer Warnung, und das NOTIFY des Absenders wird durchgehend beachtet.

  • Ein Empfänger über seinem Kontingent (der eigene Quota-Exit des Helfers) wird gemäß [pepsi] MAILBOX_OVER_QUOTA behandelt: defer (der Standardwert) wiederholt ihn wie jeden vorübergehenden Fehler, bounce routet ihn mit einem Status 5.2.2 zu QUOTA_LIMIT_STAGE (mit Rückfall auf BOUNCE_STAGE). Ein EDQUOT des Kernels zählt ebenfalls als Kontingentüberschreitung. Siehe pepsi-quota.

  • Erzeugt eine positive DSN bei erfolgreicher lokaler Zustellung, wenn [pepsi] ORIGINATE_SUCCESS_DSN gesetzt ist und der Empfänger NOTIFY=SUCCESS angefordert hat.

44.2.4. Wiederverwendete Adressen (RFC 7293)

  • Bevor sie irgendetwas schreibt, hält die Stage Login und uid jedes lokalen Empfängers in pepsi.login_assignment fest; ein Login, das unter einer neuen uid gesehen wird, hat einen neuen Inhaber, und der adressbezogene Zustand des vorherigen Inhabers wird verworfen (Ein Login, das den Eigentümer wechselt).

  • Ein Empfänger, dessen RRVS=-Parameter oder Require-Recipient-Valid-Since-Feld ein Datum vor einem festgehaltenen Inhaberwechsel nennt, wird nicht zugestellt, sondern mit 550 5.7.17 gebounct; Rollenadressen (RFC 2142) werden nie geprüft. Require-Recipient-Valid-Since-Felder werden aus der gespeicherten Kopie entfernt.

44.2.5. Privilegienmodell

  • Das Stage-Binärprogramm wird setgid pepsi-maildir installiert, Modus 2550 pepsi:pepsi-maildir. Der Dispatcher führt es als unprivilegierten pepsi-Benutzer aus; das setgid-Bit gewährt die effektive gid, die zum Ausführen des gruppenbeschränkten Helpers nötig ist, und nichts anderes auf dem Host erlangt diese Fähigkeit. Für diesen letzten Punkt gibt es den Modus 2550: Bei 2755 könnte jeder lokale Benutzer die Stage ausführen und dieselbe gid erben und von dort aus den setuid-root-Helper. pepsi kann das Ausführungsrecht nicht aus der Gruppe nehmen (es ist bewusst kein Mitglied), also nimmt es das Recht stattdessen aus den Eigentümerbits.

  • Das Programm setzt dieselbe Regel selbst durch: Mit dem setgid-Bit laufend, lehnt es einen realen Benutzer außer root oder pepsi ab, bevor es irgendeine Konfiguration liest, und entfernt die Umgebungsvariablen, die das Laden der Konfiguration steuern.

  • Der Helfer wird vollständig zum Empfänger (reale, effektive und gespeicherte IDs) und lehnt jede uid unter UID_MIN ab. Siehe Die Privilegientrennung und Ein lokaler Shell-Benutzer.

44.3. Konfiguration

[stage-<name>] mit PROGRAM = pepsi-stage-relay-to-maildir: SERVER_NAME (erforderlich), TARGETS, LOCAL_DOMAINS, RECIPIENT_DELIMITER, HELPER (Standardwert pepsi-helper-maildir-writer), NEXT_STAGE/BOUNCE_STAGE, UNKNOWN_MAILBOX_STAGE, QUOTA_LIMIT_STAGE und die Wiederholungsrichtlinie (RETRY_INITIAL/RETRY_MAX_INTERVAL/RETRY_FACTOR/MAX_LIFETIME). pepsi-setup prüft, dass UNKNOWN_MAILBOX_STAGE und QUOTA_LIMIT_STAGE echte Stages benennen. Vollständige Referenz: pepsi-stage-relay-to-maildir(1).

44.4. State

  • Eingaben: state.dsn (NOTIFY/ORCPT je Empfänger) und state.attempts (die Anzahl der Wiederholungen).

  • Ausgaben: attempts/last_error bei Pause; ein state.bounce-Objekt auf den für die Bounce-Stage eingereihten Datensätzen; das state.dsn je Empfänger wird auf jeden aufgeteilten Datensatz zugeschnitten. state.dsn/state.origin bleiben erhalten.

44.5. Siehe auch

pepsi-stage-relay-to-lmtp (die LMTP-Alternative), pepsi-stage-relay-to-smarthost, pepsi-stage-relay-to-internet, pepsi-stage-bounce, pepsi-quota, Unterstützte Funktionen, pepsi-stage-relay-to-maildir(1), pepsi-helper-maildir-writer(1).