41. pepsi-stage-aliases

Développer les destinataires d’enveloppe via une table d’alias / de liste de diffusion.

41.1. Rôle

pepsi-stage-aliases réécrit les destinataires d’enveloppe d’un message à travers un fichier de correspondance avant la remise : chaque destinataire qui correspond à une entrée de la table est remplacé par les adresses cibles de cette entrée, les destinataires qui ne correspondent à rien sont laissés inchangés, la liste résultante est dédupliquée de sorte que chaque adresse ne soit remise qu’au plus une fois, et le message avance vers NEXT_STAGE. C’est l’étape classique d’expansion /etc/aliases / de domaine virtuel, et elle est normalement placée juste avant la remise locale. Elle ne charge que l’enveloppe et state, jamais les en-têtes ni le corps, et elle ne fait jamais échouer ni ne termine un message (une table illisible est réessayée, voir ci-dessous). Référence : pepsi-stage-aliases(1).

41.2. Fonctionnalités

  • Fichier de table à la Postfix. ALIASES nomme un fichier lisible par un humain, analysé comme une table Postfix virtual(5) : chaque ligne non vide associe une clé à une ou plusieurs adresses cibles, séparées par des virgules ou des espaces. Une clé est une adresse complète, un attrape-tout @domain ou un glob * tel que sales-*@example.org. Les cibles sont conservées telles quelles ; elles doivent être des adresses complètes local@domain et ne peuvent pas elles-mêmes contenir de joker. Une clé sans cible est ignorée, de sorte qu’un destinataire n’est jamais silencieusement supprimé.

  • La correspondance la plus spécifique l’emporte. Un destinataire est mis en minuscules et consulté tel quel ; en cas d’absence, l’attrape-tout @domain est essayé, puis le joker * correspondant le plus spécifique (un sales-*@example.org étroit bat un *@example.org large, qui bat un * nu). Le détail de sous-adresse (+tag) n’est pas retiré, de sorte qu’une adresse de liste précise peut recevoir son propre alias.

  • Expansion transitive avec rupture des boucles. Lorsqu’une cible est elle-même une clé, elle est développée à son tour, de sorte que les listes de distribution imbriquées se résolvent en leurs adresses feuilles ; un cycle, ou une chaîne de plus de 32 sauts, est rompu en résolvant la clé répétée en son adresse littérale plutôt qu’en récursant à l’infini.

  • Mise en cache. La table est lue dans un cache global au processus et ré-analysée seulement lorsque l’identité du fichier (heure de modification, taille ou inode) change, de sorte qu’un worker occupé ne la relit pas à chaque message. Un fichier manquant est traité comme une table vide (aucun alias configuré). Un fichier qui existe mais ne peut être lu (permissions, erreur d’E/S) est une erreur : le message est mis en pause et réessayé comme toute autre défaillance de l’hôte, plutôt que remis sans alias. pepsi-setup vérifie la syntaxe du fichier au moment de l’installation lorsqu’il existe.

41.3. Notifications d’état de remise

state.dsn.rcpt est parallèle à la liste des destinataires ; il est donc reconstruit de concert avec les destinataires réécrits. Une cible développée hérite du NOTIFY du destinataire d’origine, privé de tout SUCCESS (un NOTIFY qui n’était que SUCCESS devient NEVER), de sorte qu’une seule soumission à un alias n’entraîne pas un DSN positif par membre. Conformément à la RFC 3461 §5.2.7, la cible porte aussi un ORCPT qui pointe vers ce destinataire d’origine (son ORCPT existant le cas échéant, sinon rfc822;<original-recipient>) et un expanded_from qui le nomme. Ainsi, un DSN au sujet de la cible ne nomme que le destinataire d’origine, avec un diagnostic générique (pepsi-stage-bounce). Grâce à la même marque, pepsi-stage-srs donne à une cible hors site une adresse de retour de réexpédition plutôt qu’une adresse SRS, de sorte qu’un rapport qu’envoie le propre serveur de la cible revient ici et reçoit la même réponse (Les adresses de retransmission dans les rapports de remise). Un destinataire non développé conserve son entrée DSN, et les RET/ENVID au niveau du message ainsi que toute autre clé de state sont préservés.

41.4. Configuration

[stage-<name>] : PROGRAM = pepsi-stage-aliases, le chemin du fichier de table ALIASES, et le NEXT_STAGE vers lequel le message développé avance. pepsi-setup crée un modèle ALIASES de démarrage lorsque le fichier manque et en vérifie la syntaxe lorsqu’il est présent. Voir pepsi-stage-aliases(1) et Configuration.

41.5. État

  • Entrées : le rcpt_to d’enveloppe et le state.dsn.rcpt parallèle.

  • Sorties : un rcpt_to réécrit et un state.dsn.rcpt correspondant (seulement lorsqu’un alias s’est appliqué ou qu’un doublon a été retiré) ; aucun autre state n’est touché.

  • Transitions : avancer vers NEXT_STAGE (la seule transition), après une retenue aléatoire d’au plus [pepsi] REFLECTION_HOLD_MAX (30 s) lorsqu’un alias s’est appliqué, car un message développé est du courrier réfléchi (Destinataires inconnus et backscatter).

41.6. Voir aussi

pepsi-stage-relay-to-maildir, pepsi-stage-relay-to-lmtp, pepsi-stage-if, Fonctionnalités prises en charge, pepsi-stage-aliases(1).