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_DOMAINSist (Standardwert[pepsi-ingress] ACCEPTED_DOMAINS), sein Postfachname auf einen passwd-Eintrag auflöst und diese uid durchTARGETSerlaubt ist.TARGETSist 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 vonUID_MINohnehin 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 zuNEXT_STAGE, das den SRS-Relay-Schwanz erreichen sollte. Ein Empfänger an einer unsererLOCAL_DOMAINS, der sich zu keinem zugelassenen Konto auflöst, ist ein unbekanntes Postfach und geht zuUNKNOWN_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_STAGEfällt standardmäßig aufNEXT_STAGEzurü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:, einDelivered-To:-Schleifenschutz und einReceived:-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_LIFETIMEund routet ihn erst dann zuBOUNCE_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 unterUID_MIN). Ein Bounce wird nie erneut gebounct, eine Stage ohneBOUNCE_STAGEverwirft den Empfänger mit einer Warnung, und dasNOTIFYdes Absenders wird durchgehend beachtet.Ein Empfänger über seinem Kontingent (der eigene Quota-Exit des Helfers) wird gemäß
[pepsi] MAILBOX_OVER_QUOTAbehandelt:defer(der Standardwert) wiederholt ihn wie jeden vorübergehenden Fehler,bounceroutet ihn mit einem Status5.2.2zuQUOTA_LIMIT_STAGE(mit Rückfall aufBOUNCE_STAGE). EinEDQUOTdes Kernels zählt ebenfalls als Kontingentüberschreitung. Siehe pepsi-quota.Erzeugt eine positive DSN bei erfolgreicher lokaler Zustellung, wenn
[pepsi] ORIGINATE_SUCCESS_DSNgesetzt ist und der EmpfängerNOTIFY=SUCCESSangefordert 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_assignmentfest; 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 oderRequire-Recipient-Valid-Since-Feld ein Datum vor einem festgehaltenen Inhaberwechsel nennt, wird nicht zugestellt, sondern mit550 5.7.17gebounct; 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-maildirinstalliert, Modus2550pepsi:pepsi-maildir. Der Dispatcher führt es als unprivilegiertenpepsi-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 Modus2550: Bei2755könnte jeder lokale Benutzer die Stage ausführen und dieselbe gid erben und von dort aus den setuid-root-Helper.pepsikann 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
rootoderpepsiab, 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_MINab. 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/ORCPTje Empfänger) undstate.attempts(die Anzahl der Wiederholungen).Ausgaben:
attempts/last_errorbei Pause; einstate.bounce-Objekt auf den für die Bounce-Stage eingereihten Datensätzen; dasstate.dsnje Empfänger wird auf jeden aufgeteilten Datensatz zugeschnitten.state.dsn/state.originbleiben 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).