43. pepsi-stage-relay-to-smarthost¶
Leitet über einen konfigurierten vorgelagerten Smarthost weiter.
43.1. Rolle¶
pepsi-stage-relay-to-smarthost leitet Mail an einen konfigurierten vorgelagerten MTA (Smarthost) weiter, nach Empfängerdomain gewählt, statt MX-Hosts direkt zu kontaktieren. Es ist die andere austauschbare Zustell-Stage. Referenz: pepsi-stage-relay-to-smarthost(1).
43.2. Funktionen¶
43.2.1. Smarthost-Routing¶
Routet jede Empfängerdomain zu dem
[…-mta-<name>], dessenDOMAINSsie auflistet, oder zum einzelnenCATCH_ALL-MTA; eine Domain ohne passenden MTA ist ein dauerhafter Fehler. Eine Domain darf nur von einem MTA aufgelistet werden. Die MTA-Abschnitte werden von allen Smarthost-Relay-Stages geteilt.Keine MX-Entdeckung und kein DNS-gelerntes MTA-STS — es spricht nur mit den konfigurierten Smarthosts.
43.2.2. Transport und Authentifizierung¶
Transport pro MTA
plain/tls(implizit) /starttls(RFC 3207, der Standard).Zertifikatsverifikation gegen den System-Store (plus ein optionales zusätzliches
TLS_CA) oder allein gegenTLS_CA_BUNDLE, das den System-Store ersetzt, sodass nur die eigene CA des Smarthosts ihn authentifizieren kann (ein unlesbares oder leeres Bundle lässt den Worker den Start verweigern);TLS_VERIFY = noakzeptiert jedes Zertifikat und übergibt damit dieAUTH-Zugangsdaten und die Mail jedem, der die Verbindung abfangen kann. Bei eingeschalteter Verifikation wird eine OCSP-Antwort, die der Smarthost anheftet, geprüft, und einerevoked-Antwort lässt die Sitzung abweisen (RFC 6960; es wird nichts abgefragt). Ein optionales Client-Zertifikat (TLS_CLIENT_CERT/TLS_CLIENT_KEY).SMTP AUTH (RFC 4954), je MTA:
none,plain,login,external,cram-md5,digest-md5,scram-sha-1/scram-sha-256und ihre-plus-Formen zur Kanalbindung,ntlm,gssapi,oauthoderauto, um das stärkste vom Server angebotene Passwortverfahren zu wählen. Die meisten nehmenUSERNAME/PASSWORD;gssapinimmtSERVICE_NAME/KRB5CCNAME,ntlmnimmtNT_DOMAIN/NT_WORKSTATIONundoauthnimmtUSERNAME/TOKEN_FILE.DANE/TLSA (RFC 7672) je MTA-Abschnitt:
DANE = off | warn | strict, Standardwertstrict(warnist ein ausdrückliches Opt-out). Ein Zertifikat, das zu einem verwendbarenTLSA-Eintrag passt, wird ohne die PKIX-Prüfung angenommen; unterwarnfällt eine Abweichung aufTLS_VERIFYzurück, sodass ein Smarthost nie schwächer verifiziert wird als mitDANE = off. EineTLSA-Abfrage, die nicht durchgeführt werden kann (einschließlich nicht auffindbarer Nameserver), wird unterstrictaufgeschoben und fällt unterwarnaufTLS_VERIFYzurück. Wo eine Verwendung und ein Selektor sowohl unter SHA-256 als auch unter SHA-512 veröffentlicht sind, werden nur die SHA-512-Einträge abgeglichen (RFC 7671 Abschnitt 9). Pepsi vertraut dem AD-Bit des Resolvers; ein Worker, der für einen MTA mit eingeschaltetem DANE gestartet wird, warnt, wenn dieser Resolver (DNS_SERVERS, sonst[pepsi] DNS_SERVERS, sonstresolv.conf) weder auf Loopback liegt noch über DNS over TLS oder HTTPS erreicht wird, oder wenn er bei einer signierten Probeantwort das AD-Bit nicht setzt; ein solcher Resolver validiert nicht, und DANE wird nie angewendet.HELO_NAMEpro MTA (StandardwertSERVER_NAME).Require TLS (RFC 8689): Eine mit
state.tls_required = "required"markierte Nachricht wird nur über validiertes TLS (TLS_VERIFY = nowird übergangen,MODE = plainbounct sie mit5.7.10) an einen Smarthost weitergeleitet, der nach dem UpgradeREQUIRETLSankündigt (sonst5.7.30), wobei der Parameter weitergegeben wird;"no"ändert hier nichts.
43.2.3. Zustellung, Wiederholung und Bounce¶
Sendet mit dem eigenen Envelope-Absender der Nachricht, einen Empfänger pro Versuch (eine Zeile mit mehreren Empfängern wird zuerst in eine Zeile je Empfänger aufgeteilt).
Bei Erfolg schließt es den Datensatz ab (oder schaltet zu
NEXT_STAGEweiter).Exponentieller Backoff bei vorübergehendem Fehler bis
MAX_LIFETIME; Schleifenerkennung überMAX_HOP_COUNT.Ein dauerhafter Fehler (einschließlich keines passenden MTA) routet zu
BOUNCE_STAGE(oder markiertfailed); ein dauerhafter Fehler eines Bounces wird verworfen, nie erneut gebounct. Abgelehnte Zugangsdaten sind ein vorübergehender Fehler, nie ein Bounce.
43.2.4. DSN und Inhaltsanpassung¶
Propagiert
RET/ENVID/NOTIFY/ORCPTan den Smarthost nur, wenn erDSNankündigt (RFC 3461); erzeugt Fehler-/Erfolgs-/Verzögerungsberichte nach denselben Regeln wie die direkte Stage.Erneutes Ankündigen oder Herabstufen von
8BITMIME/SMTPUTF8pro Hop (RFC 6152 / RFC 6531 / RFC 2045 / RFC 2047).RRVS (RFC 7293) wird weitergegeben, wenn der Smarthost es ankündigt, und sonst durch die Aktion des Empfängers bei fehlender Unterstützung genau wie in der direkten Stage behandelt.
Herkunftsnachweis: Ist
[pepsi-origin]konfiguriert (der Standard), wird jede ausgehende Nachricht mit einemPepsi-Origin-Header gestempelt, wie in pepsi-stage-relay-to-internet; der Smarthost reicht ihn durch.TLS Reporting (RFC 8460): Mit
[pepsi-tlsrpt] SEND_REPORTSwird jede TLS-Sitzung zum Smarthost inpepsi.tls_sessiongezählt (Richtlinietlsa, wenn DANE ihn authentifiziert hat, sonstno-policy-found), für pepsi-tlsrpt.
43.3. Konfiguration¶
[stage-<name>] mit PROGRAM = pepsi-stage-relay-to-smarthost: SERVER_NAME (erforderlich), NEXT_STAGE/BOUNCE_STAGE, die Timeouts (CONNECT_TIMEOUT/COMMAND_TIMEOUT/DATA_TIMEOUT), die Wiederholungsrichtlinie (RETRY_INITIAL/RETRY_MAX_INTERVAL/RETRY_FACTOR/MAX_LIFETIME/ DELAY_DSN_AFTER), MAX_HOP_COUNT, ADDRESS_FAMILY (der Standardwert, den jeder MTA-Eintrag erbt) und die DANE-Resolver-Einstellungen DNS_SERVERS/DNS_TIMEOUT. Die vorgelagerten MTAs werden in gemeinsamen [pepsi-stage-relay-to-smarthost-mta-<name>]-Abschnitten definiert: HOST/PORT (beide erforderlich), MODE, TLS_VERIFY/TLS_CA/TLS_CA_BUNDLE/TLS_CLIENT_CERT/ TLS_CLIENT_KEY, AUTH mit seinen Zugangsdaten, DANE, ADDRESS_FAMILY, HELO_NAME und Routing über DOMAINS / CATCH_ALL. Vollständige Referenz: pepsi-stage-relay-to-smarthost(1).
43.4. Privilegien¶
Installiert setgid pepsi-token (Modus 2550, Eigentümer pepsi:pepsi-token) und daher ein eigenständiges Binärprogramm statt eines der in das vereinheitlichte pepsi-Binärprogramm eingefalteten Programme. Der Dispatcher führt die Stage als unprivilegierten Benutzer pepsi aus; das setgid-Bit gibt dem Worker egid=pepsi-token, sodass er die gruppenbeschränkten Dateien lesen kann, die er braucht, ohne pepsi zu einem dauerhaften Mitglied dieser Gruppe zu machen: die OAuth-Zugriffstoken, die pepsi-helper-token-refresh schreibt (AUTH = oauth), einen TLS_CLIENT_KEY für wechselseitiges TLS und einen Kerberos-Credential-Cache (AUTH = gssapi). Die Datei ist nicht für alle ausführbar: Die Stage akzeptiert -c, sodass jeder lokale Benutzer, der sie ausführen könnte, sie auf einen eigenen Server richten und diesem Server die Zugangsdaten schicken könnte. Der Modus ist mit jedem anderen privilegierten Programm in Die Privilegientrennung aufgeführt; was ein aktiver Netzwerkangreifer einem Smarthost-Hop antun kann und was nicht (und was TLS_VERIFY = no preisgibt), steht in Ein aktiver Netzwerkangreifer.
43.5. State¶
Identisch mit pepsi-stage-relay-to-internet:
Eingaben:
state.dsn,state.originundstate.tls_required.Ausgaben:
attempts/last_error/delay_sentbei Pause; einstate.bounce-Objekt beim Routen zur/Einreihen für die Bounce-Stage;last_errorbei terminalemfail.state.dsn/state.originbleiben erhalten.
43.6. Siehe auch¶
pepsi-stage-relay-to-internet, pepsi-stage-bounce, pepsi-helper-token-refresh, Unterstützte Funktionen, pepsi-stage-relay-to-smarthost(1).