95.1.15. pepsi-stage-relay-to-lmtp¶
deliver a message to a local MDA (Dovecot) over LMTP
- Handbuchabschnitt:
1
95.1.15.1.1. Name¶
pepsi-stage-relay-to-lmtp - die LMTP-Stage der Pepsi-Pipeline für die lokale Zustellung.
95.1.15.1.2. Übersicht¶
pepsi-stage-relay-to-lmtp [GLOBAL-OPTIONS] worker
95.1.15.1.3. Beschreibung¶
pepsi-stage-relay-to-lmtp ist ein Stage-Programm, das von pepsi-dispatch(1) ausgeführt wird. Es lädt den pepsi.workqueue-Datensatz der Nachricht (und weigert sich zu handeln, sofern sein status nicht running ist), liest seinen [stage-<stage>]-Abschnitt und übergibt die Nachricht über LMTP (RFC 2033) an einen Mail Delivery Agent, typischerweise Dovecot, der sie endgültig lokal zustellt. Der MDA wendet beim Ablegen der Mail das Sieve-Skript (RFC 5228) jedes Empfängers an, sodass serverseitige Filterung (fileinto, vacation, redirect, Flag-Setzung, …) vom MDA statt von Pepsi bereitgestellt wird.
Die Stage stellt einem Empfänger je Zeile zu: Eine Nachricht mit mehreren Empfängern teilt sie zuerst in je eine Zeile auf und lässt dabei einen doppelt genannten Empfänger weg, sodass jede LMTP-Transaktion einen Empfänger hat. LMTP-Antworten nennen keinen Empfänger, daher ließe sich nach einer Störung nicht mehr sagen, zu wem eine spätere Antwort gehört, und ein langsames Sieve-Programm würde jeden Empfänger der Transaktion aufhalten. Der Preis ist eine Verbindung und ein Sieve-Lauf je Empfänger; die Zeilen teilen sich einen gespeicherten Body. Die Stage selbst baut nie eine Zustellungsstatusbenachrichtigung. Sie stellt zu und routet den Empfänger andernfalls weiter zu einer konfigurierten Stage; den Grund hält sie unter state.bounce fest, damit ein nachgelagertes pepsi-stage-bounce(1) (oder ein Relay) darauf reagieren kann. Das Schicksal jedes Empfängers folgt seiner Antwort (seiner Antwort auf das Ende von DATA oder der Ablehnung seines RCPT TO):
2xx: zugestellt; der Empfänger verlässt den Datensatz. Wenn der Empfänger
NOTIFY=SUCCESSangefordert hat,[pepsi] ORIGINATE_SUCCESS_DSNgesetzt ist und die Nachricht nicht selbst ein Bounce ist, wird eine positive Benachrichtigung zum optionalen NOTIFY_STAGE geroutet.eine permanente Ablehnung wird nach Grund geroutet; den Grund bestimmt die Stage anhand des erweiterten RFC-3463-Status der Antwort. Ein ungültiges Zielpostfach (
x.1.x, oderx.2.xaußerx.2.2, oder ein bloßes550für einen unbekannten Benutzer ohne erweiterten Status) geht an UNKNOWN_MAILBOX_STAGE, wenn der Empfänger an einer der LOCAL_DOMAINS liegt, sonst an NEXT_STAGE. Eine Ablehnung wegen Quotenüberschreitung (x.2.2) geht an QUOTA_LIMIT_STAGE (sonst an NEXT_STAGE), eine Ablehnung durch Sieve / lokale Richtlinie (x.7.x) geht an SIEVE_REJECT_STAGE (sonst an NEXT_STAGE). Alles andere geht an BOUNCE_STAGE, wenn der Empfänger an einer der LOCAL_DOMAINS liegt und diese Option gesetzt ist, und sonst an NEXT_STAGE.4xx (z. B. Server ausgelastet): ein vorübergehender Fehler. Der Empfänger wird mit exponentiellem Backoff bis MAX_LIFETIME wiederholt und danach nach derselben Einteilung der Gründe geroutet.
keine Antwort, nachdem die ganze Nachricht gesendet wurde: eine verlorene Bestätigung. Eine Zeitüberschreitung bricht beim MDA nichts ab, und er legt die Mail meist trotzdem ab, daher kann eine Wiederholung eine zweite Kopie zustellen. Die erste Wiederholung wartet mindestens 15 Minuten, die zweite mindestens 30, und ein an dieser Stage beendeter oder abgestürzter Worker zählt wie eine ausgebliebene Antwort. Nach drei solchen Versuchen, oder wenn die Stage nach einem davon aus irgendeinem Grund aufgibt, hört sie auf und routet einen Bericht an BOUNCE_STAGE (sonst NEXT_STAGE) mit
state.bounce.kindunknown. Der Absender erfährt, dass die Mail angekommen sein kann, und dass er beim Empfänger nachfragen soll. RFC 3464 hat dafür keine Aktion, daher sagt der BerichtAction: failedmitStatus: 4.4.2: Die Versuche wurden aufgegeben.
Ein Empfänger, der mit einem RRVS=-Parameter nach RFC 7293 eintraf, gibt diesen weiter, wenn der MDA RRVS ankündigt. Dovecot zum Beispiel tut das nicht. Kündigt der MDA es nicht an, lehnt die Standardaktion bei fehlender Unterstützung, R, diesen Empfänger hier mit 5.7.19 ab (geroutet wie jede x.7.x-Ablehnung). Mit C stellt die Stage ihn zu und schreibt die Anforderung als Require-Recipient-Valid-Since:-Header-Feld.
Der Datensatz eines zugestellten Empfängers endet. Ein gerouteter Empfänger wird ein pending-Datensatz an seiner Ziel-Stage, und ein aufgeschobener bleibt für die nächste Wiederholung auf seinem Datensatz. Eine DELAY-Warnung (wenn fällig und NOTIFY=DELAY angefordert wurde) wird zum NOTIFY_STAGE geroutet. All das ist eine Anweisung mit der letzten Änderung des Datensatzes (seiner Löschung oder seiner Pause bis zur Wiederholung). Schlägt diese Anweisung fehl, zum Beispiel weil die Datenbank nicht erreichbar ist, wird der Fehler wiederholt, und ein Empfänger, den der MDA angenommen hat, erhält eine zweite Kopie: Die Zustellung erfolgt mindestens einmal.
Ein Fehler der gesamten Sitzung vor jeder Antwort je Empfänger, sei es beim Verbinden, bei der Begrüßung, bei STARTTLS, bei der Authentifizierung oder bei der Datenübertragung, betrifft nicht einen einzelnen Empfänger. Nach einem vorübergehenden Fehler wird die ganze Nachricht mit Backoff wiederholt; nach einem dauerhaften (oder nach jedem, sobald MAX_LIFETIME verstrichen ist) wird jeder Empfänger ohne Bestimmung des Grundes weitergeleitet: zu BOUNCE_STAGE, wenn er an einer der LOCAL_DOMAINS liegt und diese Option gesetzt ist, sonst zu NEXT_STAGE. Manche dauerhaften Ablehnungen betreffen die Nachricht statt der Sitzung: die Ablehnung von MAIL FROM, einer Nachricht über der SIZE-Grenze des Servers oder von Inhalt, der sich für den Server nicht herabstufen lässt. Eine solche Ablehnung gilt stattdessen als Antwort jedes Empfängers und wird wie oben je Empfänger geroutet.
Jeder andere Fehler der Stage, etwa wenn die Datenbank das Auffächern ablehnt, wird wie bei jeder Stage wiederholt (nach einer Minute, dann mit verdoppeltem Abstand bis zu einer Stunde), bis MAX_LIFETIME erreicht ist; danach geht die Nachricht zu BOUNCE_STAGE, wenn der Abschnitt eines setzt (die Option, die jeder [stage-<name>]-Abschnitt annimmt), oder schlägt fehl.
Da der MDA entscheidet, welche Adressen lokal sind, führt diese Stage keinen eigenen Lokalitätstest durch (anders als pepsi-stage-relay-to-maildir(1)): Jeder Empfänger wird dem MDA angeboten. LOCAL_DOMAINS entscheidet nur, wohin ein unbekanntes Postfach anschließend geht. Ein unbekanntes Postfach an einer unserer eigenen Domains darf keine Relay-Stage erreichen, weil das Relay unseren eigenen MX nachschlagen und die Nachricht direkt an diesen Host zurückschicken würde; daher geht es an UNKNOWN_MAILBOX_STAGE. An jeder anderen Domain (ein Alias-Ziel, das nach außerhalb expandiert wurde) geht es weiter an NEXT_STAGE. Platzieren Sie die Stage dort, wo nur Empfänger ankommen, die lokal sein sollen, üblicherweise nach der Alias-Expansion (pepsi-stage-aliases(1)). Sie ist nicht terminal: NEXT_STAGE ist zwingend. Setzen Sie sie auf eine pepsi-stage-bounce(1), um nicht zustellbare Empfänger zu bouncen, oder auf eine Relay-Stage, um sie nach außerhalb weiterzuleiten. Eine Nachricht, die die Stage ohne konfigurierte NEXT_STAGE erreicht, wird als failed markiert, bevor der MDA kontaktiert wird, sodass nichts zugestellt wird.
Anders als das lokale Schreiben in Maildirs braucht LMTP keinen privilegierten Helper: Der MDA führt die Zustellung je Benutzer selbst durch, daher läuft diese Stage als der unprivilegierte Benutzer pepsi und trägt kein setuid-/setgid-Bit. Sie ist in das vereinheitlichte pepsi-Binärprogramm eingefaltet. Ein PASSWORD gehört nicht in die für alle lesbare pepsi.conf: Wenn pepsi-setup(1) die Konfiguration schreibt, verschiebt es jedes PASSWORD in das Fragment secrets.d/pepsi.secret (Modus 0640, lesbar für das Konto pepsi) und hinterlässt an seiner Stelle eine @inline-secret@-Direktive. Dem MDA wird mit dem vertraut, was die Stage ihm übergibt, wie jedem externen Helper, den der Betreiber einbindet (siehe das Kapitel Threat model des Pepsi-Handbuchs).
95.1.15.1.4. Wiederverwendete Adressen (RFC 7293)¶
Für jeden Empfänger, den der MDA angenommen hat, hält die Stage das passwd-Login hinter der Adresse mit seiner uid in pepsi.login_assignment fest (siehe pepsi-setup(1), The login assignment record), genau wie pepsi-stage-relay-to-maildir(1). Die Adresse muss in LOCAL_DOMAINS liegen, ihre Subadresse (das site-weite [pepsi] RECIPIENT_DELIMITER) wird entfernt, und der kleingeschriebene Local-Part muss einen passwd-Eintrag nennen, dessen uid in dem Bereich liegt, den /etc/login.defs für reguläre Konten festlegt. Ein Login, das unter einer anderen uid zurückkommt oder nachdem es als verschwunden erkannt wurde, hat einen neuen Inhaber: Die Datenbank verwirft in diesem Moment den adressbezogenen Zustand des vorherigen Inhabers und protokolliert das. Das braucht keine Konfiguration; nur so kann eine Site, die über einen MDA zustellt, überhaupt ein wiederverwendetes Login bemerken.
Die virtuellen Benutzer des MDA sind nicht abgedeckt: Ein Empfänger, den passwd nicht kennt, wird zugestellt, aber nicht festgehalten. Ein Wechsel seines Inhabers innerhalb des MDA wird daher nicht bemerkt, und die Einstellungen und Whitelists des vorherigen Inhabers bleiben. Die Abfragen erfolgen, bevor der MDA kontaktiert wird. Bei einem Verzeichnisausfall (ein LDAP- oder sssd-Backend, das nicht erreichbar ist) wird die Nachricht daher wie bei jedem anderen Fehler wiederholt, solange noch nichts zugestellt wurde, und der Ausfall wird nie als „kein solcher Benutzer“ gelesen. Das Festhalten folgt den Antworten des MDA je Empfänger, sodass ein Empfänger, den der MDA abgelehnt hat, nicht festgehalten wird. Ein Datenbankfehler an dieser Stelle wird protokolliert statt wiederholt, denn der MDA hat die Nachricht bereits abgelegt, und die nächste Zustellung hält das Login fest.
95.1.15.1.5. Optionen¶
Ausführungsmodus:
- worker
Läuft als persistenter pepsi-dispatch(1)-Worker, der
workqueue-Datensatz-IDs von der Standardeingabe liest.
Konfiguration (im eigenen [stage-<name>]-Abschnitt der Stage):
- PROGRAM
Muss
pepsi-stage-relay-to-lmtpsein.- NEXT_STAGE
Erforderlich. Wohin ein Empfänger, den der MDA nicht zustellen konnte, geroutet wird (ein schlechtes Zielpostfach und der Rückfall für die untenstehenden Gründe). Setzen Sie es auf ein pepsi-stage-bounce(1), um unzustellbare Empfänger zu bouncen, oder auf eine Relay-Stage (z. B. pepsi-stage-srs(1) → ein Smarthost), um sie nach außerhalb weiterzuleiten.
pepsi-setuplehnt eine Konfiguration ohne es ab.- QUOTA_LIMIT_STAGE
Wohin ein Empfänger geroutet wird, den der MDA wegen Über-Quota abgelehnt hat (RFC 3463
x.2.2). Standardwert ist NEXT_STAGE. Setzen Sie es auf eine Bounce-Stage, wenn NEXT_STAGE ein Relay ist, damit Quota-Ablehnungen bouncen statt nach außerhalb weiterzuleiten.- SIEVE_REJECT_STAGE
Wohin ein von Sieve / lokaler Richtlinie abgelehnter Empfänger geroutet wird (RFC 3463
x.7.x). Standardwert ist NEXT_STAGE.- UNKNOWN_MAILBOX_STAGE
Wohin ein Empfänger an einer der LOCAL_DOMAINS geroutet wird, den der MDA als unbekanntes Postfach abgelehnt hat (
x.1.x, ein bloßes550). Standardwert ist NEXT_STAGE. Setzen Sie sie auf eine Bounce-Stage, wann immer NEXT_STAGE ein Relay erreichen kann: Eine unbekannte Adresse an unserer eigenen Domain weiterzuleiten stellt sie an diesen Host zurück zu.pepsi-setup --wizardsetzt sie aufbounce.- LOCAL_DOMAINS
Die Domains, deren Postfächer der MDA hält (durch Leerzeichen oder Kommas getrennt). Standardwert ist
[pepsi-ingress] ACCEPTED_DOMAINS. Gelesen für UNKNOWN_MAILBOX_STAGE, für das Login-Zuordnungsverzeichnis (nur ein Empfänger in diesen Domains wird in passwd nachgeschlagen; siehe Wiederverwendete Adressen oben) und von der Empfängerprüfung von pepsi-ingress(1), die den MDA fragt, ob eine Adresse an diesen Domains existiert, bevor sie angenommen wird (sieheVERIFY_RECIPIENTS).- NOTIFY_STAGE
Wohin positive SUCCESS-Zustellbenachrichtigungen und DELAY-Warnungen geroutet werden (als geklonte Nachricht, die
state.bounce.kindträgt); setzen Sie es auf ein pepsi-stage-bounce(1), das den Bericht rendert. Wenn nicht gesetzt, werden keine positiven oder Delay-Benachrichtigungen erzeugt. Die Stage baut nie selbst eine Benachrichtigung.- SOCKET
Pfad des LMTP-UNIX-Domain-Sockets des MDA (z. B.
/run/dovecot/lmtp). Das ist das übliche Layout für lokale Zustellung, ohne TLS und ohne Authentifizierung. Genau eines von SOCKET und HOST muss gesetzt sein.- HOST / PORT
Erreicht den MDA stattdessen über TCP (
PORTist standardmäßig 24). Verwenden Sie dies für einen MDA auf einem anderen Host.- TLS
Transportsicherheit für ein HOST-Ziel:
off(Standardwert),starttlsodertls(implizit).TLS_VERIFY(Standardwert ja) undTLS_CAsteuern die PKIX-Verifikation;TLS_CLIENT_CERT/TLS_CLIENT_KEYlegen ein Client-Zertifikat für Mutual TLS / SASLEXTERNALvor.- AUTH
SASL-Mechanismus für ein TCP-Ziel:
none(Standardwert),plain,loginoderexternal. Authentifizierung wird über Klartext abgelehnt, sodass jedes Nicht-none-AUTHTLS = starttlsodertlserfordert (undexternalein Client-Zertifikat erfordert).USERNAME/PASSWORDliefern die Zugangsdaten (beide erforderlich fürplainundlogin; beiexternalist ein optionalesUSERNAMEdie Autorisierungsidentität). Ein SOCKET-Ziel nimmt überhaupt keinAUTHan.- SERVER_NAME
Der in
LHLOangekündigte und imReceived:-Header gestempelte Name. Standardwert ist[pepsi-ingress] HOSTNAME; einer der beiden muss gesetzt sein.- RETRY_INITIAL, RETRY_MAX_INTERVAL, RETRY_FACTOR, MAX_LIFETIME
Wann ein vorübergehend aufgeschobener Empfänger erneut versucht wird und wann die Stage aufgibt. Dauern verwenden die Einheiten
h/m/s. Standardwerte:60 s,15 m,2und120 h.- DELAY_DSN_AFTER
Gibt eine einmalige „delayed“-Benachrichtigung an NOTIFY_STAGE aus, sobald eine noch nicht zugestellte Nachricht so lange eingereiht war und der (erste aufgeschobene) Empfänger
NOTIFY=DELAYangefordert hat. Standardmäßig nicht gesetzt (keine Verzögerungswarnungen); ohne NOTIFY_STAGE ohne Wirkung.- CONNECT_TIMEOUT, COMMAND_TIMEOUT, DATA_TIMEOUT
Zeitüberschreitungen je LMTP-Operation. Standardwerte:
60 s,120 sund600 s. Eine Zeitüberschreitung beendet die Sitzung: Bereits erhaltene Antworten bleiben gültig, und jeder noch offene Empfänger wird aufgeschoben. Eine Wiederholung kann einem Empfänger, dessen Bestätigung zu spät kam, eine zweite Kopie zustellen.
95.1.15.1.6. Siehe auch¶
pepsi-dispatch(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-aliases(1), pepsi-stage-bounce(1), pepsi.conf(5), pepsi.state(7).
RFC 2033 (LMTP), RFC 5228 (Sieve).