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/report RFC 3464) : l’expéditeur d’enveloppe devient l’expéditeur nul <>, le destinataire devient l’expéditeur d’origine (state.srs.original lorsque pepsi-stage-srs en a noté un, sinon la colonne mail_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, 0 pour 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_MESSAGE nomme un modèle, la partie lisible par un humain du DSN est rendue à partir de bounce-<NAME>.<lang>.body sous [pepsi] TEMPLATE_DIR, avec l’intégralité du state de la ligne. <lang> suit state.language dans l’ordre des q, avec repli sur en : 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 NOTIFY a demandé FAILURE (la valeur par défaut en son absence) ; NOTIFY=NEVER (ou une liste sans FAILURE) 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 sous ORIGINATE_SUCCESS_DSN + NOTIFY=SUCCESS) ;

    • delay → Action: delayed (un avertissement DELAY_DSN_AFTER d’une étape de relais).

  • Renvoie en écho les ENVID/ORCPT d’origine dans Original-Envelope-Id / Original-Recipient lorsqu’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 comme Final-Recipient et donne un Diagnostic-Code générique de la même classe (550 <status> delivery to a forwarded address failed) en conservant le Status: é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/report en 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éfaut drop) : 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 un From: 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 (sans state.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_LIFETIME ou était permanente, un plantage de worker, ou pepsi-failure-bouncer) : la ligne est scindée en une ligne par destinataire, le NOTIFY/ORCPT/RET de state.dsn propre à chaque destinataire est honoré, et le DSN porte un diagnostic générique choisi d’après state.failure_class (Status: 5.4.7, 5.3.0, 5.6.0, 5.7.1 ou 5.0.0) ; state.last_error n’y est jamais copié.

  • Le contenu du courrier arrivé chiffré est retenu : quoi que demande RET, le DSN ne cite que From/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 champs X-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’étiquette state.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) et state.bounce avec kind, 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 le Status: du DSN), et les notify/orcpt/envid/ret copiés. Sans state.bounce, le rapport est construit à partir de state.failed_stage/state.failure_class et de l’entrée state.dsn du destinataire. state.auth/state.local_origin contrôlent le destinataire du DSN, state.crypto.in décide si le contenu est retenu et state.language choisit 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 le state de l’original sous son propre enregistrement bounce, 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 rebond RET=FULL.

  • Sorties : remplace state par {"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 son MAX_LIFETIME à partir de sa construction. C’est la seule étape qui rejette le state qu’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ées state.dsn en 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).