95.1.11. pepsi-stage-relay-to-internet¶
deliver a message directly to the recipient’s MX hosts
- Section du manuel:
1
95.1.11.1.1. Nom¶
pepsi-stage-relay-to-internet - l’étape de remise directe vers le MX du pipeline Pepsi.
95.1.11.1.2. Synopsis¶
pepsi-stage-relay-to-internet [GLOBAL-OPTIONS] worker
pepsi-stage-relay-to-internet [GLOBAL-OPTIONS] mta-sts DOMAIN
95.1.11.1.3. Description¶
pepsi-stage-relay-to-internet est un programme d’étape exécuté par pepsi-dispatch(1) comme un worker persistant lisant les identifiants de message sur l’entrée standard. Il charge cette ligne pepsi.workqueue (refusant d’agir si son status n’est pas running), lit sa section [stage-<stage>], et remet le message directement aux serveurs MX du domaine destinataire, en utilisant l’expéditeur d’enveloppe propre au message (l’expéditeur nul <> pour les rebonds). La remise se fait à raison d’un destinataire par tentative : une ligne qui contient encore plusieurs destinataires est d’abord scindée en une ligne par destinataire (chacune avec sa tranche de state.dsn), qui toutes rentrent dans cette étape. Un message portant plus de MAX_HOP_COUNT champs d’en-tête Received: est traité comme une boucle de courrier et échoue définitivement.
Il effectue sa propre résolution DNS MX : les hôtes candidats sont essayés par préférence MX croissante (les hôtes à préférence égale dans un ordre aléatoire), un domaine sans enregistrement MX se replie sur ses enregistrements d’adresse (le MX implicite de la RFC 5321 §5.1), et un domaine inexistant ou un null MX RFC 7505 est un échec permanent. Un null MX est signalé comme 556 avec le code d’état étendu 5.1.10 (RFC 7505 §4.1), afin que le rebond indique que l’adresse ne pourra jamais être remise au lieu de ressembler à n’importe quel autre 550. Les adresses A/AAAA de chaque hôte MX sont sélectionnées avec Happy-Eyeballs et mises en cache, par adresse, dans la table dns_address ; le réglage ADDRESS_FAMILY (intersecté avec les familles que l’hôte peut router) choisit lesquelles utiliser. Les connexions se font sur le port 25. Chaque requête porte sur le nom pleinement qualifié, de sorte qu’une liste search dans /etc/resolv.conf n’est jamais appliquée : sans cela, un domaine sans enregistrement MX serait résolu une seconde fois sous chaque domaine de recherche. Le NXDOMAIN qui en résulte serait alors signalé à la place du NODATA du domaine lui-même, ce qui transformerait une remise ordinaire par MX implicite en échec permanent.
Sauf désactivation par MTA_STS = no, la politique MTA-STS (RFC 8461) du domaine destinataire est honorée : une politique enforce restreint la remise aux hôtes MX listés via STARTTLS avec un certificat qui valide pour l’hôte, faisant échouer le message (transitoirement) lorsqu’aucun MX ne correspond. Une politique testing est validée de la même manière, et la tentative et son issue sont notées pour le TLS Reporting, mais elle ne bloque jamais la remise : un échec de sécurité du transport (ou une politique qui ne correspond à aucun MX) retombe sur un STARTTLS opportuniste vers tous les hôtes MX, de sorte que le propriétaire du domaine apprend des rapports si enforce casserait son courrier avant d’y basculer. Les domaines sans politique utilisent un STARTTLS opportuniste. Les consultations de politique ne sont fail-open que lorsque rien n’est en cache ; avec le TLS Reporting activé, une récupération échouée d’une politique annoncée est alors consignée comme sts-policy-fetch-error (sts-webpki-invalid pour un certificat qui n’a pas été validé pour le nom de l’hôte de politique ou contre les racines du système), au plus une fois par domaine et par worker toutes les cinq minutes, de sorte que le propriétaire du domaine apprend que son hôte de politique était injoignable. Le fichier de politique n’est récupéré que depuis une adresse publique : un hôte de politique qui se résout uniquement vers la boucle locale, une plage privée ou link-local (métadonnées cloud comprises), du CGNAT, de l’IPv6 unique-local ou une autre adresse non publique n’est pas contacté, puisqu’un domaine destinataire pourrait sinon diriger la récupération vers l’intérieur du déploiement ; cela compte comme une récupération échouée.
Les politiques sont mises en cache pour leur max_age (plafonné à une semaine) dans la table pepsi.mta_sts_policy, partagée par tous les workers et conservée à travers le recyclage des workers et les redémarrages, de sorte qu’une politique une fois récupérée reste appliquée même si l’enregistrement _mta-sts est ensuite retiré ou l’hôte de politique bloqué (RFC 8461 §5.1) ; une ligne expirée n’est jamais appliquée, et pepsi-queue gc la supprime. Seules les politiques utilisables (enforce/testing) sont stockées. L”id du TXT _mta-sts est revérifié à chaque utilisation d’une politique en cache (RFC 8461 §3.1) : un id modifié déclenche une nouvelle récupération immédiate, tandis qu’un enregistrement transitoirement injoignable (ou l’échec de la récupération d’une politique modifiée) conserve la politique en cache encore valide. Un hôte de politique qui renvoie un 5xx/429 transitoire est traité comme « récupération échouée » (fail open, non mis en cache comme « pas de politique »), tandis qu’un 404, un corps qui n’est pas text/plain, mode: none ou une politique inanalysable est une absence définitive : elle retire une politique en cache pour le domaine, et chaque worker s’en souvient (en mémoire seulement) pendant cinq minutes avant de redemander.
Une politique en cache est rafraîchie lors de son utilisation dès qu’il lui reste moins de la moitié de sa durée de vie (son max_age, plafonné à une semaine) (RFC 8461 section 10.2) : le fichier de politique est récupéré à nouveau même lorsque l”id est inchangé ou que l’enregistrement _mta-sts a disparu, et une récupération réussie stocke à nouveau la politique pour toute sa durée de vie, de sorte qu’un domaine qui reçoit régulièrement du courrier ne revient jamais au stade du « premier contact ». Un rafraîchissement qui échoue, ou ne trouve aucune politique utilisable sous l”id inchangé, conserve la politique en cache (un domaine retire sa politique en publiant mode: none sous un nouvel id, RFC 8461 section 8.3) ; le worker attend alors cinq minutes avant de réessayer, et dès qu’il reste moins d’un quart de la durée de vie, chaque échec est journalisé comme avertissement, de sorte qu’un rafraîchissement qui échoue sans cesse est remarqué avant que la politique n’expire.
Les politiques stockées sont aussi rafraîchies sans qu’un message ne les demande, comme le demande la RFC 8461 section 10.2 : gc de pepsi-queue(1), exécuté toutes les heures, récupère selon les mêmes règles chaque politique stockée dont la moitié de la durée de vie est écoulée (ou à laquelle il reste moins de trois heures), en utilisant les DNS_SERVERS, DNS_TIMEOUT et MTA_STS_TIMEOUT de la première section d’étape exécutant ce programme avec MTA_STS activé. Un domaine qui continue de publier une politique ne retombe donc jamais au stade d’un premier contact, aussi rarement qu’il reçoive du courrier ; une politique dont les rafraîchissements échouent sans cesse est conservée jusqu’à l’épuisement de son max_age.
DANE (RFC 7672) : lorsque DANE vaut strict (la valeur par défaut) ou warn et que l’hôte MX de destination publie des enregistrements TLSA validés par DNSSEC, le certificat du MX est authentifié contre eux plutôt que par PKIX ; cela a priorité sur MTA-STS pour cette connexion. DANE repose sur DNSSEC. Pepsi fait confiance au bit AD (Authentic Data) de la réponse plutôt que de valider lui-même ; le résolveur configuré (DNS_SERVERS, sinon [pepsi] DNS_SERVERS, sinon resolv.conf) doit donc valider et doit être atteint par un chemin de confiance : la boucle locale, ou DNS over TLS ou HTTPS (une entrée tls:// ou https://, voir pepsi.conf(5)). Les réponses TLSA (et MX) sans le bit AD sont traitées comme « pas de DANE ». Un worker démarré avec DANE activé journalise un avertissement lorsque ce résolveur n’est ni une adresse de boucle locale ni atteint par une entrée chiffrée, et un autre lorsqu’il ne valide pas : le worker lui demande le SOA signé de ietf.org et avertit lorsque la réponse n’a pas le bit AD (DANE est alors configuré mais jamais appliqué) ou ne vient pas. pepsi-status(1) montre la même vérification dans sa section « DNSSEC resolver ». En mode strict, un enregistrement utilisable qui ne correspond pas diffère le message comme un échec transitoire, comme l’exige la RFC 7672 section 2.2, et il en va de même d’une consultation TLSA ou de sécurité MX qui échoue (par exemple pour un enregistrement DNSSEC bogus). En mode warn, un renoncement explicite pour les opérateurs qui préfèrent que le courrier continue de circuler vers des pairs aux enregistrements TLSA périmés, la non-concordance est journalisée et la remise se poursuit avec la vérification de certificat non vérifiée qui s’applique sans DANE. Dans les deux cas, STARTTLS est obligatoire pour un tel hôte (RFC 7672 section 2.2 : un RRset TLSA sécurisé signifie que toute connexion à l’hôte doit utiliser TLS) : warn assouplit la vérification du certificat, jamais TLS lui-même. Si un hôte ne propose pas STARTTLS, ou si un attaquant retire cette offre de la réponse, le message est différé plutôt qu’envoyé en clair.
Cette priorité ne vaut que là où DANE est au moins aussi fort que ce qu’il remplace. Pour un hôte couvert par une politique MTA-STS enforce, le mode warn n’est pas utilisé, car une non-concordance en mode warn accepte n’importe quel certificat, ce qui écarterait l’exigence de validation de la RFC 8461 §5 imposée par la politique. Le certificat est alors validé par PKIX et la substitution est journalisée. Le mode strict y garde la priorité. Un domaine qui ne publie tout simplement aucun enregistrement TLSA est remis normalement même en mode strict : DANE est opportuniste et ne s’applique que lorsque des enregistrements existent. Un domaine qui publie des enregistrements TLSA dont aucun n’est utilisable (un usage PKIX, ou un type de correspondance que ce build n’implémente pas) n’est pas la même chose : d’après la RFC 7672 §2.2, il a tout de même engagé l’hôte à faire du TLS. STARTTLS devient donc obligatoire pour lui, non authentifié mais jamais en clair, et un saut qui ne le propose pas diffère le message. Là où un même usage et un même sélecteur sont publiés avec à la fois un enregistrement SHA-256 et un SHA-512 (types de correspondance 1 et 2), seuls les enregistrements SHA-512 sont comparés (RFC 7671 section 9, agilité des algorithmes de condensat) : le condensat le plus faible n’est publié que pour les clients qui ne disposent pas du plus fort, et le comparer malgré tout laisserait la connexion exactement aussi forte que ce condensat plus faible. Le type de correspondance 0 (les données complètes) est toujours comparé.
Révocation (RFC 6960) : partout où le certificat du MX est validé par PKIX (sous une politique MTA-STS, pour un message REQUIRETLS, ou comme repli DANE warn), une réponse OCSP que le serveur agrafe dans la poignée de main (status_request de la RFC 6066) est vérifiée contre l’émetteur du certificat, ou un répondeur que l’émetteur a autorisé. Une réponse revoked en cours de validité fait refuser la session comme tout autre échec de certificat ; sur une session opportuniste, elle est seulement journalisée. Une réponse absente, périmée ou invérifiable laisse le certificat non vérifié, et aucun répondeur n’est jamais interrogé. En cas de correspondance DANE-TA (usage 2), l’agrafe est évaluée de la même manière et un revoked vérifié annule la correspondance. Pour un certificat auquel correspond un enregistrement DANE-EE (usage 3), l’agrafe n’est pas consultée : cet enregistrement lie la session à la clé que le domaine publie actuellement.
Require TLS (RFC 8689) : un message marqué state.tls_required = "required" (il est arrivé avec le paramètre REQUIRETLS de MAIL FROM, voir pepsi-ingress(1)) n’est envoyé que dans les conditions de la RFC 8689 §4.2.1, quoi que publie le domaine destinataire. Les noms de ses hôtes MX doivent être validés, soit par DNSSEC (le RRset MX porte le bit AD, ce qui nécessite DANE activé et un résolveur validant), soit par une politique MTA-STS. Une politique MTA-STS compte en mode enforce comme testing, puisque ce sont la récupération authentifiée de la politique et sa correspondance d’hôtes qui valident les noms. Un domaine qui n’offre ni l’un ni l’autre est un échec permanent (5.7.10). STARTTLS est obligatoire et le certificat est authentifié par DANE là où l’hôte publie des enregistrements TLSA utilisables (une non-concordance en mode warn retombe ici sur PKIX, jamais sur la vérification qui accepte tout) et par PKIX contre les racines du système sinon (RFC 6125, le nom de l’hôte MX). Après la mise à niveau, l’hôte doit annoncer REQUIRETLS, et le paramètre est transmis. Un hôte qui échoue à l’une de ces conditions reçoit un QUIT et l’hôte MX suivant est essayé ; lorsqu’aucun ne peut prendre le message, celui-ci rebondit avec 5.7.30 (pas de REQUIRETLS au saut) ou 5.7.10 (pas de TLS validé). Si un hôte a échoué pour une raison transitoire qu’un réessai pourrait lever, le message est plutôt réessayé. Le rebond est lui-même marqué : il voyage sous la même exigence, ne renvoie que les en-têtes (RET=HDRS, RFC 8689 §5) et est envoyé avec le paramètre là où le chemin de retour l’annonce, mais n’est pas refusé pour un saut dépourvu de l’extension (§5) ; un rebond qui ne peut pas être renvoyé sous l’exigence est abandonné, et sa copie au postmaster est soumise à la même règle. Un message marqué "no" (il portait TLS-Required: No) est remis selon la RFC 8689 §4.2.2 à chaque hôte MX via un STARTTLS opportuniste : une politique MTA-STS enforce ne restreint pas les hôtes ni n’exige TLS, et les enregistrements TLSA utilisables sont comparés mais une non-concordance ne fait qu’avertir. Une poignée de main qui échoue après que STARTTLS a été proposé n’est toujours jamais réessayée en clair (un attaquant pourrait provoquer cet échec), de sorte qu’un tel saut diffère le message. Les sessions d’un message "no" ne sont pas consignées pour le TLS Reporting : l’originateur a demandé que les échecs de politique soient ignorés, et un tel échec n’est donc rien que le propriétaire du domaine devrait apprendre.
SMTP TLS Reporting (RFC 8460) : lorsque [pepsi-tlsrpt] SEND_REPORTS est activé, l’issue de chaque session TLS est notée comme un compteur agrégé dans pepsi.tls_session, indexé par la politique appliquée (tlsa/sts/no-policy-found) et l’hôte MX. Cette issue est un succès ou un échec classé (starttls-not-supported, validation de certificat/poignée de main ou DANE/MTA-STS). pepsi-tlsrpt(1) les compile ensuite en rapports quotidiens. La prise de note est au mieux (un hoquet de base de données ne fait jamais échouer une remise) et est omise pour un message de rapport lui-même (state.tlsrpt).
Un hôte qui refuse la session par une réponse 5xx au message d’accueil, à EHLO, à HELO ou à STARTTLS n’a rien dit du destinataire : l’hôte MX suivant est donc essayé (RFC 5321 section 5.1). Un tel refus n’est signalé comme échec permanent que lorsqu’aucun hôte ne prend le message et qu’aucun n’a échoué de façon transitoire ; un 5xx à MAIL FROM, à RCPT TO ou à DATA met fin immédiatement à la tentative.
Un hôte qui répond à EHLO par 500 ou 502 ne connaît pas la commande : l’étape le salue donc par HELO à la place (RFC 5321 section 3.2). Un tel hôte n’annonce aucune extension : le message est converti en 7 bits là où c’est nécessaire, et un saut qui doit utiliser TLS échoue de façon transitoire, car il n’offre pas STARTTLS.
En cas de succès, la ligne est supprimée (ou avancée si l’étape définit NEXT_STAGE). Un échec transitoire met le message en pause avec un backoff exponentiel (remis en file par pepsi-dispatch(1) lorsque son timeout s’écoule) ; au-delà de MAX_LIFETIME, l’échec est traité comme permanent. Un échec permanent d’un message ordinaire est acheminé vers le BOUNCE_STAGE de l’étape (ou, si aucun n’est configuré, la ligne est marquée failed). Un échec permanent d’un rebond (expéditeur nul) ne rebondit jamais à nouveau. Si POSTMASTER est défini, la ligne est tout ce qui reste du rapport : elle n’est donc supprimée qu’une fois une copie remise à cette adresse. Tant que le serveur MX du postmaster diffère la copie, la ligne continue d’être réessayée comme toute autre ; lorsque la copie est refusée, ou encore différée au-delà de MAX_LIFETIME, la ligne est marquée failed pour qu’un opérateur la trouve. pepsi-failure-bouncer(1) supprime une telle ligne après son MIN_AGE, puisqu’un rebond ne rebondit jamais. Sans POSTMASTER, le rebond est abandonné, de même qu’un rebond adressé à POSTMASTER lui-même.
DSN (RFC 3461) : lorsque le MX du destinataire annonce l’extension DSN, les paramètres que l’origine a demandés lui sont propagés : RET/ENVID et les NOTIFY/ORCPT du destinataire, lus dans le state.dsn de la ligne. Sinon, ils sont omis. En cas d’échec permanent, les NOTIFY/ORCPT du destinataire et l”ENVID sont remis à l’étape de rebond, de sorte qu’un DSN d’échec n’est généré que s’il a été demandé. Cette étape préserve state.dsn.
RRVS (RFC 7293) : un destinataire arrivé avec un paramètre RRVS= (conservé dans state.dsn.rcpt) le voit transmis tel quel, action de non-prise en charge comprise, lorsque le MX annonce RRVS. Lorsqu’il ne l’annonce pas, l’action par défaut R fait échouer définitivement le destinataire avec 5.7.19 (un DSN, de sorte que l’expéditeur apprend que la demande n’a pas pu être appliquée), et C continue avec la demande écrite sous forme de champ d’en-tête Require-Recipient-Valid-Since: nommant ce seul destinataire – chaque transaction de relais porte un seul destinataire, de sorte que le champ ne divulgue jamais la date d’un destinataire à un autre.
Lorsque le ORIGINATE_SUCCESS_DSN global de [pepsi] est activé et que le destinataire d’une remise réussie a demandé NOTIFY=SUCCESS, le message est acheminé (après remise) vers BOUNCE_STAGE, qui émet un rapport positif (Action: delivered) à l’expéditeur. Avec l’indicateur désactivé, ou sans demande SUCCESS, une remise réussie est simplement terminée.
Lorsque DELAY_DSN_AFTER est défini et qu’un message encore non remis a passé au moins cette durée en file, un DSN « delayed » (Action: delayed) unique est envoyé à l’expéditeur — mais seulement si l’expéditeur a demandé NOTIFY=DELAY (le délai n’a pas de valeur par défaut implicite). Le message d’origine continue d’être réessayé ; l’avertissement est un message distinct acheminé via BOUNCE_STAGE, et il est envoyé au plus une fois.
Preuve d’origine : lorsque la section partagée [pepsi-origin] est configurée (activée par défaut ; pepsi-setup(1) génère un secret si aucun n’est défini), chaque message sortant est estampillé d’un en-tête Pepsi-Origin avant la remise, et le nonce est noté dans pepsi.origin_nonce (valide pendant deux semaines). L’en-tête contient un HMAC sur le compte expéditeur d’origine, un nonce frais de 128 bits, un horodatage et notre HOSTNAME. Le même estampillage est partagé avec pepsi-stage-relay-to-smarthost(1), de sorte qu’un message emporte une preuve quel que soit le chemin sortant qu’il emprunte. Un rebond de retour intègre cet en-tête, ce qui permet à pepsi-stage-anti-spam(1) de confirmer que le rebond répond à un courrier que nous avons réellement envoyé. L’en-tête est ajouté en tête comme l’en-tête de trace Received: (au-dessus de toute signature existante, de sorte qu’il n’en perturbe aucune) et est laissé non signé. Un nonce qui ne peut être noté (une erreur de base de données) retient le message, qui est réessayé comme toute défaillance de l’hôte (voir pepsi-dispatch(1)) : un en-tête dont le nonce n’est pas enregistré ferait paraître falsifié tout rebond de ce message. Sans la section [pepsi-origin], aucun en-tête n’est ajouté ; une section dont le secret ne peut être lu empêche les workers de l’étape de démarrer (la file est retenue, et le journal dit pourquoi), exactement comme pepsi-setup(1) la refuse.
Rétrogradation du contenu (RFC 6152 / RFC 6531) : le message est adapté aux extensions que le MX annonce réellement plutôt qu’envoyé tel quel. Lorsque le corps contient des octets 8 bits et que le MX prend en charge 8BITMIME, l’enveloppe porte BODY=8BITMIME ; lorsqu’il ne le prend pas en charge, l’arbre MIME est parcouru et chaque partie feuille 8 bits est ré-encodée avec un codage de transfert de contenu 7 bits (quoted-printable pour text/*, base64 sinon). Ce qu’une partie déclare n’est pas pris pour preuve de ce qu’elle contient : une partie étiquetée base64 qui transporte des octets 8 bits bruts est ré-encodée elle aussi, et un multipart/* dont le boundary= déclaré n’apparaît nulle part dans son corps n’a aucune partie à préserver et est encodé en entier. Le résultat est ensuite retesté, car le parcours est au mieux sur un message que personne n’a validé (un arbre imbriqué au-delà du plafond de profondeur est recopié tel quel) : un corps portant encore des octets 8 bits est un échec permanent (554) plutôt que quelque chose à mettre sur le fil, ce que la RFC 6152 §3 interdit « en toutes circonstances ».
Lorsque le message a besoin de SMTPUTF8 (UTF-8 dans les en-têtes ou l’enveloppe) et que le MX le prend en charge, l’enveloppe porte SMTPUTF8 ; sinon, les champs d’en-tête UTF-8 sont réécrits en mots encodés RFC 2047. Ceux-ci sont placés aux trois endroits où la RFC 2047 §5 en autorise un, afin que le champ s’analyse toujours : un corps de champ non structuré, une phrase de nom affiché (une chaîne entre guillemets devient un mot encodé, sans les guillemets) et l’intérieur d’un comment (les parenthèses restent). Un paramètre Content-Type ou Content-Disposition non ASCII, pour lequel la §5 n’a pas de mot encodé, prend à la place la forme étendue de la RFC 2231 (filename*=UTF-8''caf%C3%A9.txt, découpée en sections *0*/*1* lorsqu’une ligne ne suffirait pas à la contenir) ; les paramètres ASCII sont copiés tels qu’écrits. Cela couvre le bloc d’en-têtes de chaque partie MIME, et pas seulement celui du message, puisque c’est là que se trouve le nom de fichier d’une pièce jointe. Un boundary= non ASCII n’a aucune forme encodée : il doit correspondre octet pour octet aux lignes de délimitation du corps, et la RFC 2046 ne lui autorise que des caractères 7 bits. Plutôt que de faire rebondir le message, Pepsi donne à la partie multiple une nouvelle frontière ASCII aléatoire et réécrit ses lignes de délimitation en conséquence. Un en-tête de partie qui ne peut pas être converti (par exemple des octets Latin-1 bruts) est copié tel quel et laissé au nouveau test 8BITMIME, puisque le transport le voit comme du contenu de corps. Une adresse d’enveloppe non ASCII, et un octet non ASCII à l’intérieur d’une adresse d’en-tête, ne peuvent pas être rétrogradés : vers un saut sans SMTPUTF8, un tel message est un échec permanent (il rebondit). Ré-encoder un corps casse nécessairement toute signature couvrant le corps déjà présente sur le message (le hachage de corps DKIM de l’originateur et l”ARC-Message-Signature de pepsi-stage-arc(1)) ; c’est inévitable, puisque les capacités du MX ne sont connues qu’après la sélection du MX, et rare en pratique. La propre signature DKIM de Pepsi n’est pas affectée dans le cas courant : pepsi-stage-dkim-sign(1) convertit un corps 8 bits en 7 bits avant de signer, de sorte qu’il ne reste ici rien à ré-encoder.
95.1.11.1.4. Configuration¶
Le câblage du pipeline et chaque option opérationnelle résident dans la section [stage-<name>] propre à l’étape (PROGRAM = pepsi-stage-relay-to-internet) : les identités SERVER_NAME/POSTMASTER, EHLO_FROM_PTR (annoncer le nom PTR confirmé dans le sens direct de l’adresse locale de chaque connexion), les timeouts de connexion, le calendrier de backoff des réessais et MAX_LIFETIME, DELAY_DSN_AFTER, MAX_HOP_COUNT, les paramètres DNS, MTA_STS/MTA_STS_TIMEOUT, ADDRESS_FAMILY et DANE. Ils sont documentés dans pepsi.conf(5).
95.1.11.1.5. État¶
Entrées (lues dans le state de la ligne ; toutes facultatives) :
state.dsn— les paramètres RFC 3461 (ret/envidau niveau du message etnotify/orcptdu premier destinataire) ; propagés au MX lorsqu’il annonceDSNet consultés pour conditionner les rapports d’échec/de succès/de délai.state.origin— les indications 8BITMIME/SMTPUTF8 (body_8bit,smtputf8) qu’utilise la décision de rétrogradation du contenu.state.tls_required— l’étiquette RFC 8689 ("required"ou"no"), voir Require TLS ci-dessus.
Sorties (fusionnées dans le state de la ligne) :
Sur un échec transitoire (
pause) :attempts,last_erroret, une fois qu’un DSN de délai a été émis,delay_sent.Sur un échec permanent avec un
BOUNCE_STAGE(reroute), ou sur un avertissement de délai (un clone mis en file) : un objetstate.bounce(kind=permanentoudelay) pour pepsi-stage-bounce(1). Pour un échec au niveau SMTP, il note aussi le détail structuré du saut suivant —remote_mta(le domaine du destinataire),smtp_code,enhanced_status,phaseetreply_text— de sorte que le rebond puisse énoncer précisément pourquoi la remise a été refusée.Sur une remise réussie avec
ORIGINATE_SUCCESS_DSNetNOTIFY=SUCCESS: un objetstate.bounceaveckind = success.Sur un échec permanent sans
BOUNCE_STAGE(fail) :last_error.
state.dsn, state.origin et state.tls_required sont toujours préservés. La disposition de l’état est décrite intégralement dans pepsi.state(7).
Transitions (le calendrier de réessai est RETRY_INITIAL / RETRY_FACTOR / RETRY_MAX_INTERVAL, borné par MAX_LIFETIME) :
remise réussie → terminer (la ligne est supprimée), ou avancer vers NEXT_STAGE s’il en existe un ; avec [pepsi] ORIGINATE_SUCCESS_DSN et un destinataire qui a demandé
NOTIFY=SUCCESS, elle réachemine à la place vers BOUNCE_STAGE pour émettre un DSN positif (Action: delivered) ;échec transitoire → pause pour le prochain intervalle de réessai ;
encore en file au-delà de DELAY_DSN_AFTER avec un destinataire
NOTIFY=DELAY→ mettre en file un clone unique de DSN de délai à BOUNCE_STAGE (l’original reste en file et continue d’être réessayé) ;échec permanent, ou MAX_LIFETIME épuisé → réacheminer vers BOUNCE_STAGE, ou échouer (
failedterminal) si aucun BOUNCE_STAGE n’est configuré ;un rebond non remettable (expéditeur nul) ne rebondit jamais à nouveau : si POSTMASTER est défini, la ligne est terminée une fois qu’une copie y est remise, mise en pause tant que la copie est différée, et mise en échec (fail) lorsque la copie est refusée ou que MAX_LIFETIME est épuisé ; sans lui, la ligne est terminée.
95.1.11.1.6. Commandes¶
- worker
Exécuté comme un worker persistant de pepsi-dispatch(1), lisant les identifiants de message sur l’entrée standard.
- mta-sts DOMAIN
Diagnostic : résoudre et afficher la politique MTA-STS qui s’appliquerait lors d’une remise vers DOMAIN. Utilise le résolveur système et n’a besoin d’aucune configuration de message ni d’étape.
95.1.11.1.7. Options globales¶
- -c FILE, –config FILE
Lit la configuration depuis FILE au lieu de parcourir les emplacements par défaut.
- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de journalisation (par défaut
[pepsi] LOG, sinoninfo).- -v, –verbose
Affiche les messages de journal de toutes les sources.
- -h, –help ; -V, –version
Affiche un résumé d’utilisation / la version et quitte.
95.1.11.1.8. Code de sortie¶
L’issue de chaque message est signalée à pepsi-dispatch(1) sur la ligne d’état du worker, et non par le code de sortie.
- 0
Le worker a tourné jusqu’à la fermeture de son entrée standard, ou la consultation mta-sts s’est terminée.
- 1
Une erreur fatale s’est produite (le fichier de configuration n’a pas pu être lu, la base de données n’a pas pu être ouverte, ou l’entrée/sortie standard a échoué). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer : sa section
[stage-<name>],[pepsi],[pepsi-tlsrpt]ou[pepsi-origin]ne s’analyse pas (ou le secret d’origine ne peut pas être lu), ou le schéma de la base de données ne correspond pas à cette version. Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.
95.1.11.1.9. Exemples¶
Exécuter l’étape sur le message 42 (il doit être running)
echo 42 | pepsi-stage-relay-to-internet -c /etc/pepsi/pepsi.conf worker
Vérifier quelle politique MTA-STS s’applique à un domaine destinataire
pepsi-stage-relay-to-internet -c /etc/pepsi/pepsi.conf mta-sts example.com
95.1.11.1.10. Voir aussi¶
pepsi-config(1), pepsi-stage-bounce(1), pepsi-stage-dkim-sign(1), pepsi-stage-relay-to-smarthost(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
Les garanties de sécurité du transport et leurs limites (ce qu’un attaquant réseau actif peut encore faire avec et sans MTA-STS ou DANE) sont énoncées dans le chapitre Modèle de menace du manuel de Pepsi ; le tableau des programmes privilégiés et l’hypothèse sur le résolveur DNS se trouvent dans son chapitre Sécurité.
95.1.11.1.11. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.