46. pepsi-stage-relay-to-lmtp¶
Stellt lokal über LMTP an einen MDA (Dovecot) zu, der Sieve ausführt.
46.1. Rolle¶
pepsi-stage-relay-to-lmtp ist eine lokale Zustell-Stage, die jede Nachricht über LMTP (RFC 2033) an einen Mail Delivery Agent übergibt, typischerweise Dovecot. Der MDA legt die Nachricht ab und führt dabei das Sieve-Skript (RFC 5228) des Empfängers aus, sodass serverseitige Filterung an den MDA delegiert wird, statt in Pepsi implementiert zu werden. Es ist eine Alternative zu pepsi-stage-relay-to-maildir. Mit LMTP gewinnen Sie Sieve und einen sauberen Zustellstatus je Empfänger und brauchen keinen setuid-Helper (der MDA führt die Zustellung je Benutzer durch); dafür müssen Sie einen lokalen IMAP/LMTP-Server betreiben.
46.2. LMTP-native Zustellung, Zustellen-und-Routen¶
Die Stage stellt einem Empfänger je Zeile zu, also einem Empfänger je LMTP-Transaktion. Eine Nachricht mit mehreren Empfängern wird zuerst aufgeteilt, und ein doppelt genannter Empfänger wird weggelassen. LMTP-Antworten nennen keinen Empfänger (RFC 2033 §4.2), 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 baut nie selbst eine Zustellungsstatusbenachrichtigung. Sie stellt zu und routet den Empfänger andernfalls nach Grund weiter. Den Grund hält sie unter state.bounce fest, damit ein nachgelagertes pepsi-stage-bounce (oder ein Relay) darauf reagieren kann:
2xx— zugestellt; eineNOTIFY=SUCCESS-Benachrichtigung (undDELAY-Warnungen) wird zum optionalenNOTIFY_STAGEgeroutet;eine dauerhafte Ablehnung wird nach ihrem erweiterten RFC-3463-Status geroutet. Ein schlechtes Postfach (
x.1.x,x.2.xaußerx.2.2, sowie ein bloßes550ganz ohne erweiterten Status) geht zuUNKNOWN_MAILBOX_STAGE, wenn der Empfänger in einer derLOCAL_DOMAINSliegt (Standardwert[pepsi-ingress] ACCEPTED_DOMAINS), sonst zuNEXT_STAGE. Eine Quota-Überschreitung (x.2.2) geht zuQUOTA_LIMIT_STAGE(sonstNEXT_STAGE), eine Sieve- oder Richtlinien-Ablehnung (x.7.x) zuSIEVE_REJECT_STAGE(sonstNEXT_STAGE). Alles andere geht zuBOUNCE_STAGE, wenn der Empfänger in einer derLOCAL_DOMAINSliegt und diese Option gesetzt ist, und sonst zuNEXT_STAGE;4xx— vorübergehend: diesen Empfänger wiederholen (exponentieller Backoff) bisMAX_LIFETIME, dann nach derselben Klassifizierung routen;keine Antwort, nachdem die ganze Nachricht gesendet wurde — eine verlorene Bestätigung, nach der niemand weiß, ob der MDA die Mail abgelegt hat. Die Stage wartet vor einer Wiederholung mindestens 15 Minuten, und nach drei solchen Versuchen oder bei jedem späteren Aufgeben routet sie einen Bericht an
BOUNCE_STAGE(sonstNEXT_STAGE), der dem Absender sagt, dass das Ergebnis unbekannt ist. An dieser Stage beendete Worker zählen ebenfalls.
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. Ein Fehlschlag der gesamten Sitzung (Verbindungsaufbau, STARTTLS, Authentifizierung, Datenübertragung) wird ebenfalls wiederholt. Ist dieser Fehlschlag dauerhaft oder ist MAX_LIFETIME überschritten, routet die Stage den Empfänger stattdessen weiter.
Ein Empfänger mit einer RRVS=-Anforderung nach RFC 7293 gibt diese weiter, wenn der MDA RRVS ankündigt; Dovecot tut das nicht, daher wird dieser Empfänger standardmäßig (Aktion R) hier mit 5.7.19 abgelehnt und wie eine Richtlinien-Ablehnung geroutet, während Aktion C ihn zustellt (siehe Ein Login, das den Eigentümer wechselt).
Weil der MDA die maßgebliche Instanz dafür ist, welche Adressen lokal sind, führt die Stage keine eigene Lokalitätsprüfung durch. Platzieren Sie sie nach der Alias-Expansion, sodass nur die als lokal vorgesehenen Empfänger sie erreichen. NEXT_STAGE ist verpflichtend (setzen Sie es auf ein pepsi-stage-bounce, um zu bouncen, oder auf eine Relay-Stage, um nach außerhalb weiterzuleiten); eine Nachricht, die die Stage ohne eines erreicht, wird als failed markiert, bevor der MDA kontaktiert wird, sodass nichts zugestellt wird.
46.3. Transport¶
Das Ziel ist entweder ein UNIX-Domain-Socket (SOCKET, das übliche Dovecot-Layout: kein TLS, keine Zugangsdaten) oder TCP (HOST/PORT, PORT Standardwert 24) mit optionalem TLS = off|starttls|tls und AUTH = none|plain|login|external. Authentifizierung wird über Klartext abgelehnt, sodass jedes AUTH außer none TLS erfordert. Der gemeinsame LMTP-Client verwendet die Transport-, TLS- und SASL-Maschinerie des SMTP-Clients wieder (pepsi_common::smtp::deliver_lmtp).
Die Stage läuft als der unprivilegierte Benutzer pepsi und trägt kein setuid- oder setgid-Bit; der MDA übernimmt die Zustellung je Benutzer und wird mit dem, was ihm übergeben wird, vertraut, wie jeder externe Helfer, den der Betreiber einbindet (Beteiligte und wie weit jedem vertraut wird). Ein PASSWORD wird aus der für alle lesbaren pepsi.conf herausgehalten: pepsi-setup verschiebt es nach secrets.d/pepsi.secret.
46.4. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-relay-to-lmtp, NEXT_STAGE (verpflichtend), die optionalen Grundziele QUOTA_LIMIT_STAGE / SIEVE_REJECT_STAGE / UNKNOWN_MAILBOX_STAGE (mit LOCAL_DOMAINS) / NOTIFY_STAGE, das Ziel (SOCKET, oder HOST/PORT mit TLS, TLS_VERIFY, TLS_CA, TLS_CLIENT_CERT, TLS_CLIENT_KEY, AUTH und dessen USERNAME/PASSWORD), SERVER_NAME (der LHLO-Name; Standardwert ist [pepsi-ingress] HOSTNAME), die Zeitüberschreitungen (CONNECT_TIMEOUT/COMMAND_TIMEOUT/DATA_TIMEOUT) und die Wiederholungsrichtlinie (RETRY_INITIAL/RETRY_MAX_INTERVAL/RETRY_FACTOR/MAX_LIFETIME/ DELAY_DSN_AFTER). pepsi-setup verlangt NEXT_STAGE und prüft, dass jedes der vier optionalen Ziele eine echte Stage benennt. Die Stage baut nie selbst eine DSN. Die gemeinsame Option BOUNCE_STAGE erhält, wenn gesetzt, einen Empfänger in LOCAL_DOMAINS, den keine andere Option abdeckt, und eine Nachricht, deren Stage-Fehler über MAX_LIFETIME hinaus andauerte.
46.5. State¶
Eingaben:
state.dsn(NOTIFY/ORCPTje Empfänger) und die Wiederholungsbuchführung, die sie in einem früheren Durchlauf geschrieben hat.Ausgaben:
state.bounceauf jedem gerouteten Geschwister-Datensatz (hält fest, warum der MDA abgelehnt hat, oder dass die Zustellung für eineSUCCESS-/DELAY-Benachrichtigung gelungen ist) sowieattempts/last_error(dazudelay_sent, sobald eine Verzögerungswarnung geroutet wurde) auf dem zurückgestellten Datensatz.state.dsn.rcptwird im Gleichschritt mit den Empfängern jedes Datensatzes zurechtgeschnitten.
46.6. Siehe auch¶
pepsi-stage-relay-to-maildir, pepsi-stage-aliases, pepsi-stage-bounce, pepsi-quota, Unterstützte Funktionen, pepsi-stage-relay-to-lmtp(1), pepsi.conf(5).