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>], dessen DOMAINS sie auflistet, oder zum einzelnen CATCH_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 gegen TLS_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 = no akzeptiert jedes Zertifikat und übergibt damit die AUTH-Zugangsdaten und die Mail jedem, der die Verbindung abfangen kann. Bei eingeschalteter Verifikation wird eine OCSP-Antwort, die der Smarthost anheftet, geprüft, und eine revoked-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-256 und ihre -plus-Formen zur Kanalbindung, ntlm, gssapi, oauth oder auto, um das stärkste vom Server angebotene Passwortverfahren zu wählen. Die meisten nehmen USERNAME/PASSWORD; gssapi nimmt SERVICE_NAME/KRB5CCNAME, ntlm nimmt NT_DOMAIN/NT_WORKSTATION und oauth nimmt USERNAME/TOKEN_FILE.

  • DANE/TLSA (RFC 7672) je MTA-Abschnitt: DANE = off | warn | strict, Standardwert strict (warn ist ein ausdrückliches Opt-out). Ein Zertifikat, das zu einem verwendbaren TLSA-Eintrag passt, wird ohne die PKIX-Prüfung angenommen; unter warn fällt eine Abweichung auf TLS_VERIFY zurück, sodass ein Smarthost nie schwächer verifiziert wird als mit DANE = off. Eine TLSA-Abfrage, die nicht durchgeführt werden kann (einschließlich nicht auffindbarer Nameserver), wird unter strict aufgeschoben und fällt unter warn auf TLS_VERIFY zurü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, sonst resolv.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_NAME pro MTA (Standardwert SERVER_NAME).

  • Require TLS (RFC 8689): Eine mit state.tls_required = "required" markierte Nachricht wird nur über validiertes TLS (TLS_VERIFY = no wird übergangen, MODE = plain bounct sie mit 5.7.10) an einen Smarthost weitergeleitet, der nach dem Upgrade REQUIRETLS ankündigt (sonst 5.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_STAGE weiter).

  • Exponentieller Backoff bei vorübergehendem Fehler bis MAX_LIFETIME; Schleifenerkennung über MAX_HOP_COUNT.

  • Ein dauerhafter Fehler (einschließlich keines passenden MTA) routet zu BOUNCE_STAGE (oder markiert failed); 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/ORCPT an den Smarthost nur, wenn er DSN ankündigt (RFC 3461); erzeugt Fehler-/Erfolgs-/Verzögerungsberichte nach denselben Regeln wie die direkte Stage.

  • Erneutes Ankündigen oder Herabstufen von 8BITMIME/SMTPUTF8 pro 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 einem Pepsi-Origin-Header gestempelt, wie in pepsi-stage-relay-to-internet; der Smarthost reicht ihn durch.

  • TLS Reporting (RFC 8460): Mit [pepsi-tlsrpt] SEND_REPORTS wird jede TLS-Sitzung zum Smarthost in pepsi.tls_session gezählt (Richtlinie tlsa, wenn DANE ihn authentifiziert hat, sonst no-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.origin und state.tls_required.

  • Ausgaben: attempts/last_error/delay_sent bei Pause; ein state.bounce-Objekt beim Routen zur/Einreihen für die Bounce-Stage; last_error bei terminalem fail. state.dsn/state.origin bleiben 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).