43. pepsi-stage-relay-to-smarthost¶
Relayer via un smarthost amont configuré.
43.1. Rôle¶
pepsi-stage-relay-to-smarthost relaie le courrier vers un MTA amont configuré (smarthost) choisi par domaine de destinataire, au lieu de contacter directement les hôtes MX. C’est l’autre étape de remise interchangeable. Référence : pepsi-stage-relay-to-smarthost(1).
43.2. Fonctionnalités¶
43.2.1. Acheminement smarthost¶
Achemine chaque domaine de destinataire vers le
[…-mta-<name>]dont leDOMAINSle liste, ou vers l’unique MTACATCH_ALL; un domaine sans MTA correspondant est un échec permanent. Un domaine ne peut être listé que par un seul MTA. Les sections MTA sont partagées entre toutes les étapes de relais vers smarthost.Pas de découverte MX ni de MTA-STS appris par DNS — il ne parle qu’aux smarthosts configurés.
43.2.2. Transport et authentification¶
Transport par MTA
plain/tls(implicite) /starttls(RFC 3207, la valeur par défaut).Vérification de certificat par rapport au magasin système (plus un
TLS_CAsupplémentaire facultatif), ou par rapport au seulTLS_CA_BUNDLE, qui remplace le magasin système de sorte que seule l’AC propre au smarthost puisse l’authentifier (un bundle illisible ou vide fait refuser le worker) ;TLS_VERIFY = noaccepte n’importe quel certificat et remet donc les identifiantsAUTHet le courrier à quiconque peut intercepter la connexion. Avec la vérification activée, une réponse OCSP que le smarthost agrafe est vérifiée et une réponserevokedfait refuser la session (RFC 6960 ; rien n’est interrogé). Un certificat client facultatif (TLS_CLIENT_CERT/TLS_CLIENT_KEY).SMTP AUTH (RFC 4954), par MTA :
none,plain,login,external,cram-md5,digest-md5,scram-sha-1/scram-sha-256et leurs formes-plusde liaison de canal,ntlm,gssapi,oauth, ouautopour choisir le mécanisme par mot de passe le plus robuste que le serveur propose. La plupart prennentUSERNAME/PASSWORD;gssapiprendSERVICE_NAME/KRB5CCNAME,ntlmprendNT_DOMAIN/NT_WORKSTATION, etoauthprendUSERNAME/TOKEN_FILE.DANE/TLSA (RFC 7672) par section de MTA :
DANE = off | warn | strict, par défautstrict(warnest un renoncement explicite). Un certificat qui correspond à un enregistrementTLSAutilisable est accepté sans la vérification PKIX ; souswarn, une non-concordance retombe surTLS_VERIFY, de sorte qu’un smarthost n’est jamais moins vérifié qu’avecDANE = off. Une rechercheTLSAqui ne peut pas être faite (y compris lorsque les serveurs de noms ne peuvent pas être trouvés) diffère le message sousstrictet retombe surTLS_VERIFYsouswarn. Là où un même usage et un même sélecteur sont publiés à la fois en SHA-256 et en SHA-512, seuls les enregistrements SHA-512 sont comparés (RFC 7671 section 9). Pepsi fait confiance au bit AD du résolveur ; un worker démarré avec DANE activé pour un MTA avertit lorsque ce résolveur (DNS_SERVERS, sinon[pepsi] DNS_SERVERS, sinonresolv.conf) n’est ni sur la boucle locale ni joint par DNS over TLS ou HTTPS, ou lorsqu’il ne positionne pas le bit AD sur une réponse de sonde signée ; un tel résolveur ne valide pas, et DANE n’est jamais appliqué.HELO_NAMEpar MTA (par défautSERVER_NAME).Require TLS (RFC 8689) : un message marqué
state.tls_required = "required"n’est relayé que sur un TLS validé (TLS_VERIFY = noest outrepassé,MODE = plainle fait rebondir avec5.7.10) vers un smarthost qui annonceREQUIRETLSaprès la mise à niveau (sinon5.7.30), le paramètre étant transmis ;"no"ne change rien ici.
43.2.3. Remise, réessai et rebond¶
Envoie avec l’expéditeur d’enveloppe propre au message, un destinataire par tentative (une ligne à plusieurs destinataires est d’abord scindée en une ligne par destinataire).
En cas de succès, termine la ligne (ou avance vers
NEXT_STAGE).Backoff exponentiel sur échec transitoire jusqu’à
MAX_LIFETIME; détection de boucle viaMAX_HOP_COUNT.Un échec permanent (y compris l’absence de MTA correspondant) achemine vers
BOUNCE_STAGE(ou marquefailed) ; un échec permanent d’un rebond est abandonné, jamais rebondi à nouveau. Un identifiant rejeté est un échec transitoire, jamais un rebond.
43.2.4. DSN et adaptation du contenu¶
Propage
RET/ENVID/NOTIFY/ORCPTau smarthost seulement lorsqu’il annonceDSN(RFC 3461) ; génère des rapports d’échec, de succès et de délai selon les mêmes règles que l’étape directe.Ré-annonce ou rétrogradation par saut de
8BITMIME/SMTPUTF8(RFC 6152 / RFC 6531 / RFC 2045 / RFC 2047).RRVS (RFC 7293) transmis lorsque le smarthost l’annonce, sinon traité par l’action de non-prise en charge du destinataire exactement comme dans l’étape directe.
Preuve d’origine : avec
[pepsi-origin]configuré (par défaut), chaque message sortant est tamponné d’un en-têtePepsi-Origin, comme dans pepsi-stage-relay-to-internet ; le smarthost le laisse passer.TLS Reporting (RFC 8460) : avec
[pepsi-tlsrpt] SEND_REPORTS, chaque session TLS vers le smarthost est comptée danspepsi.tls_session(politiquetlsalorsque DANE l’a authentifiée, sinonno-policy-found) pour pepsi-tlsrpt.
43.3. Configuration¶
[stage-<name>] avec PROGRAM = pepsi-stage-relay-to-smarthost : SERVER_NAME (obligatoire), NEXT_STAGE/BOUNCE_STAGE, les timeouts (CONNECT_TIMEOUT/COMMAND_TIMEOUT/DATA_TIMEOUT), la politique de réessai (RETRY_INITIAL/RETRY_MAX_INTERVAL/RETRY_FACTOR/MAX_LIFETIME/ DELAY_DSN_AFTER), MAX_HOP_COUNT, ADDRESS_FAMILY (la valeur par défaut dont hérite chaque entrée MTA) et les réglages du résolveur DANE DNS_SERVERS/DNS_TIMEOUT. Les MTA amont sont définis dans des sections partagées [pepsi-stage-relay-to-smarthost-mta-<name>] : HOST/PORT (tous deux obligatoires), MODE, TLS_VERIFY/TLS_CA/TLS_CA_BUNDLE/TLS_CLIENT_CERT/ TLS_CLIENT_KEY, AUTH avec ses identifiants, DANE, ADDRESS_FAMILY, HELO_NAME, et le routage via DOMAINS / CATCH_ALL. Référence complète : pepsi-stage-relay-to-smarthost(1).
43.4. Privilège¶
Installé setgid pepsi-token (mode 2550, propriétaire pepsi:pepsi-token), et donc binaire autonome plutôt que l’un des programmes pliés dans le binaire pepsi unifié. Le dispatcher exécute l’étape sous l’utilisateur non privilégié pepsi ; le bit setgid donne au worker egid=pepsi-token, afin qu’il puisse lire les fichiers restreints au groupe dont il a besoin sans faire de pepsi un membre permanent de ce groupe : les jetons d’accès OAuth qu’écrit pepsi-helper-token-refresh (AUTH = oauth), une clé TLS_CLIENT_KEY de TLS mutuel et un cache d’identifiants Kerberos (AUTH = gssapi). Le fichier n’est pas exécutable par tous : l’étape accepte -c, de sorte que tout utilisateur local qui pourrait l’exécuter pourrait la pointer vers un serveur à lui et envoyer les identifiants à ce serveur. Le mode est listé avec tous les autres programmes privilégiés dans La séparation des privilèges ; ce qu’un attaquant réseau actif peut et ne peut pas faire à un saut vers un smarthost (et ce que TLS_VERIFY = no abandonne) est énoncé dans Un attaquant réseau actif.
43.5. État¶
Identique à pepsi-stage-relay-to-internet :
Entrées :
state.dsn,state.originetstate.tls_required.Sorties :
attempts/last_error/delay_sentà la mise en pause ; un objetstate.bouncelors de l’acheminement vers l’étape de rebond ou de la mise en file pour celle-ci ;last_erroraufailterminal.state.dsn/state.originpréservés.
43.6. Voir aussi¶
pepsi-stage-relay-to-internet, pepsi-stage-bounce, pepsi-helper-token-refresh, Fonctionnalités prises en charge, pepsi-stage-relay-to-smarthost(1).