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.
ALIASESnomme 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@domainou un glob*tel quesales-*@example.org. Les cibles sont conservées telles quelles ; elles doivent être des adresses complèteslocal@domainet 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
@domainest essayé, puis le joker*correspondant le plus spécifique (unsales-*@example.orgétroit bat un*@example.orglarge, 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-setupvé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_tod’enveloppe et lestate.dsn.rcptparallèle.Sorties : un
rcpt_toréécrit et unstate.dsn.rcptcorrespondant (seulement lorsqu’un alias s’est appliqué ou qu’un doublon a été retiré) ; aucun autrestaten’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).