40. pepsi-stage-bounce¶
Réécrire un message en une notification d’état de remise (DSN).
40.1. Rôle¶
pepsi-stage-bounce transforme un message en un DSN RFC 3464 : un rebond d’échec ou, sur demande, un rapport positif ou de délai. Une étape de remise achemine ici un message échoué ou remis via son BOUNCE_STAGE. Le DSN est produit non signé et avancé vers NEXT_STAGE (normalement pepsi-stage-dkim-sign, puis une étape de remise) après une retenue aléatoire d’au plus [pepsi] REFLECTION_HOLD_MAX (30 s), comme tout courrier réfléchi (Destinataires inconnus et backscatter). Références : pepsi-stage-bounce(1) / pepsi.conf(5).
40.2. Fonctionnalités¶
Réécriture sur place en un DSN (
multipart/reportRFC 3464) : l’expéditeur d’enveloppe devient l’expéditeur nul<>, le destinataire devient l’expéditeur d’origine (state.srs.originallorsque pepsi-stage-srs en a noté un, sinon la colonnemail_from), et le corps cite les en-têtes d’origine ; les codes d’état étendus de la RFC 3463 sont utilisés.RET=FULL (RFC 3461 §6.2) : lorsque l’expéditeur a demandé le retour du message entier, l’étape charge le corps et le renvoie intégralement. C’est l’unique aller-retour supplémentaire de l’arborescence, effectué uniquement pour un tel message. Si le corps dépasse
RET_FULL_MAX_SIZE(par défaut 256 Kio,0pour désactiver la limite), le DSN se rabat sur les seuls en-têtes, comme le §6.2 l’autorise explicitement.Texte fourni par l’opérateur. Lorsque
BOUNCE_MESSAGEnomme un modèle, la partie lisible par un humain du DSN est rendue à partir debounce-<NAME>.<lang>.bodysous[pepsi] TEMPLATE_DIR, avec l’intégralité dustatede la ligne.<lang>suitstate.languagedans l’ordre desq, avec repli suren: l’avis est adressé à l’expéditeur d’origine, et la langue détectée dans son message est le meilleur indicateur disponible de ce qu’il lit (sans détection sur le chemin, l’avis est en anglais). Tout échec de rendu se rabat sur le texte intégré, de sorte qu’un rebond est toujours produit.Tient compte de NOTIFY (RFC 3461) : un rapport d”échec n’est émis que lorsque
NOTIFYa demandéFAILURE(la valeur par défaut en son absence) ;NOTIFY=NEVER(ou une liste sansFAILURE) abandonne le message silencieusement.Trois sortes de rapport, sélectionnées par
state.bounce.kind:permanent→Action: failed(le rebond d’échec par défaut) ;success→Action: delivered(seulement lorsqu’une étape de remise l’a émis sousORIGINATE_SUCCESS_DSN+NOTIFY=SUCCESS) ;delay→Action: delayed(un avertissementDELAY_DSN_AFTERd’une étape de relais).
Renvoie en écho les
ENVID/ORCPTd’origine dansOriginal-Envelope-Id/Original-Recipientlorsqu’ils sont présents.Garde confidentielles les adresses de réexpédition : pour un destinataire produit par un développement d’alias ou de
~/.forward(expanded_from), le DSN nomme l’adresse qu’a utilisée l’expéditeur commeFinal-Recipientet donne unDiagnostic-Codegénérique de la même classe (550 <status> delivery to a forwarded address failed) en conservant leStatus:étendu ; la cible et la vraie réponse ne vont qu’au journal (RFC 3464 §4.2). Le même DSN répond au rapport d’un hôte distant au sujet d’une copie réexpédiée : pepsi-ingress transforme un rapport envoyé à l’adresse de retour de réexpédition de la copie en une ligne à cette étape (state.forward_return) et abandonne le rapport (Les adresses de retransmission dans les rapports de remise).Rien à citer, pas de troisième partie : lorsqu’un DSN n’a rien du message à citer, c’est un
multipart/reporten deux parties (RFC 6522 §3). C’est le cas du rapport au sujet d’une copie réexpédiée d’un message arrivé chiffré.Ne fait jamais rebondir un rebond (RFC 5321 §6.1) : un message à expéditeur nul est supprimé, non réécrit.
Pas de backscatter (
BOUNCE_UNAUTHENTICATED, par défautdrop) : aucun rapport ne part vers un expéditeur d’enveloppe que le message entrant n’a pas authentifié (réussite SPF pour son domaine, ou réussite DKIM alignée pour unFrom:de ce domaine, d’un parent ou d’un sous-domaine). Le courrier soumis par nos propres utilisateurs et les messages créés par une étape (sansstate.auth) font toujours l’objet d’un rapport ; un rapport abandonné au sujet d’un échec sur cet hôte est journalisé comme avertissement.Échecs sur cet hôte (pas de
state.bounce: l’erreur d’une étape a survécu àMAX_LIFETIMEou était permanente, un plantage de worker, ou pepsi-failure-bouncer) : la ligne est scindée en une ligne par destinataire, leNOTIFY/ORCPT/RETdestate.dsnpropre à chaque destinataire est honoré, et le DSN porte un diagnostic générique choisi d’aprèsstate.failure_class(Status:5.4.7,5.3.0,5.6.0,5.7.1ou5.0.0) ;state.last_errorn’y est jamais copié.Le contenu du courrier arrivé chiffré est retenu : quoi que demande
RET, le DSN ne cite queFrom/Sender/To/Cc/Date/Message-ID, que le déchiffrement ait réussi ou non, de sorte que le DSN ne peut ni remettre du texte en clair à quiconque a renvoyé un texte chiffré capturé ni révéler s’il s’est ouvert. Chaque bloc d’en-têtes cité perd les champsX-Pepsi-*de Pepsi.Un message ``REQUIRETLS`` rebondit avec les en-têtes seulement (la RFC 8689 §5 ne tient pas compte de
RET=FULL), et le DSN hérite de l’étiquettestate.tls_required, de sorte que les étapes de relais ne le renvoient que sur un TLS validé.Aucune E/S réseau : le message réécrit est remis par ce que nomme
NEXT_STAGE; le rebond est laissé non signé pour l’étape de signature DKIM.
40.3. Sécurité¶
Deux des fonctionnalités ci-dessus sont des mécanismes de sécurité. La règle anti-backscatter est la seconde couche de « Unknown recipients and backscatter » dans Modèle de sécurité (protégeant la réputation d’envoi de l’hôte, Actifs, contre Un expéditeur distant). Retenir le contenu du courrier arrivé chiffré relève de « Bounces and replies to encrypted mail » dans ce même chapitre : cela empêche le texte en clair que la passerelle a ouvert d’atteindre quiconque est l’expéditeur d’enveloppe, et empêche le DSN d’être un oracle de déchiffrement (Garde par la passerelle (custody = local, la clé de MTA), Les rebonds après déchiffrement à la passerelle révèlent le contenu déchiffré, Oracles de remplissage et de format CBC contre S/MIME non authentifié). Le diagnostic d’un échec sur cet hôte ne cite jamais state.last_error, qui peut nommer des fichiers, des objets de base de données et des hôtes. Qu’un rebond ne rebondisse jamais fait partie de l’analyse des boucles de Disponibilité.
40.4. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-bounce, SERVER_NAME (obligatoire ; utilisé dans ``From:``/``Reporting-MTA``/``Message-ID``), POSTMASTER (le From: du rebond et l’identité DKIM ; par défaut postmaster@<SERVER_NAME>), BOUNCE_MESSAGE (le nom du modèle ; non réglé, le texte intégré est utilisé), RET_FULL_MAX_SIZE (par défaut 256 Kio), BOUNCE_UNAUTHENTICATED (drop/send, par défaut drop) et NEXT_STAGE (obligatoire ; normalement une étape de signature DKIM : le DSN est construit non signé, donc sans elle chaque rebond échoue une fois le DSN déjà composé). Voir pepsi.conf(5).
40.5. État¶
Entrées :
state.srs.original(le destinataire du DSN, lorsqu’il est présent) etstate.bounceaveckind,diagnostic,failed_recipient, le détail structuré du saut suivant que les étapes de relais enregistrent (remote_mta/smtp_code/enhanced_status/phase/reply_text, qui alimente aussi leStatus:du DSN), et lesnotify/orcpt/envid/retcopiés. Sansstate.bounce, le rapport est construit à partir destate.failed_stage/state.failure_classet de l’entréestate.dsndu destinataire.state.auth/state.local_origincontrôlent le destinataire du DSN,state.crypto.indécide si le contenu est retenu etstate.languagechoisit la langue du modèle ;state.tls_required(RFC 8689) impose la forme en-têtes seulement et est reporté sur le DSN. Un rapport créé comme ligne distincte à côté de l’original (un rebond ou un avis de succès par destinataire, un avertissement de délai) porte lestatede l’original sous son propre enregistrementbounce, de sorte que les mêmes vérifications s’y appliquent. Le bloc d’en-têtes est chargé ; le corps ne l’est que pour un rebondRET=FULL.Sorties : remplace
statepar{"retry_since": <now>}, car le rebond est un nouveau message à expéditeur nul qui n’hérite d’aucune provenance de l’original, et les étapes ultérieures comptent sonMAX_LIFETIMEà partir de sa construction. C’est la seule étape qui rejette lestatequ’elle reçoit. Les autres étapes le conservent et y ajoutent leurs propres clés ; une étape qui modifie les destinataires reconstruit en outre les entréesstate.dsnen conséquence.
40.6. Voir aussi¶
pepsi-stage-dkim-sign, pepsi-stage-relay-to-internet, pepsi-stage-discard, pepsi-failure-bouncer, Fonctionnalités prises en charge, pepsi-stage-bounce(1), pepsi.conf(5).