83. pepsi-stage-list-deliver¶
Fait de la copie d’un message de liste la copie propre d’un membre.
83.1. Rôle¶
pepsi-stage-list-post a déjà produit un enregistrement par destinataire ; pepsi-stage-list-deliver est ce qui fait de chacun d’eux la copie de ce membre plutôt qu’une copie de plus du même message. Un enregistrement entre, un enregistrement sort. L’étape achève List-Unsubscribe avec l’URI https: en un clic propre à ce membre, à côté de la forme mailto:, et ajoute List-Unsubscribe-Post: List-Unsubscribe=One-Click (RFC 8058). Lorsque le personalize de la liste vaut individual ou full, elle décore le message avec l’en-tête et le pied de page de la liste dans la langue du membre. Pour full seulement, elle réécrit aussi To: pour nommer le membre : le personalize_to d’amont ne fait rien pour individual, et cette étape non plus. Référence : pepsi-stage-list-deliver(1).
Ce sous-système est une réimplémentation de GNU Mailman 3 ; voir Listes de diffusion, qui nomme ce qui a été repris d’amont.
Avertissement
Cette étape doit s’exécuter avant la signature. Chaque en-tête qu’elle touche appartient à la liste h= de DKIM, et List-Unsubscribe est précisément l’en-tête qu’un fournisseur de boîtes inspecte pour décider s’il affiche un bouton de désabonnement. Un pipeline qui signerait d’abord produirait du courrier signé puis modifié, qui échoue à DKIM partout. NEXT_STAGE pointe donc vers pepsi-stage-dkim-sign et non vers un relais, et pepsi-setup refuse l’ordre inverse. Amont dit la même chose dans le commentaire qui retire arc-sign de son propre pipeline.
83.2. Désabonnement en un clic¶
Le jeton de l’URI https: est un condensé à clé calculé sur la liste, l’adresse du membre et un numéro de série que le membre peut faire tourner. Il n’est pas stocké : une URI List-Unsubscribe est émise une fois par membre et par message, une table de ces URI croîtrait donc avec les remises et non avec les membres. Il en découle trois conséquences.
Le jeton ne voyage jamais entre les étapes : celle-ci détient le secret et calcule le jeton pour chaque copie.
Révoquer toutes les URI jamais émises pour un abonnement consiste à incrémenter le
unsubscribe_serialde ce membre : une mise à jour de compteur et non un balayage de table.Il n’y a rien à faire expirer, car un abonnement qui n’existe plus échoue à la recherche d’appartenance, quoi que dise le jeton.
Le secret est [pepsi-list] UNSUBSCRIBE_SECRET. Sans secret, ou sans BASE_URL pour construire une URI, la forme mailto: reste seule, comme chez amont : une URI invérifiable est pire que pas d’URI. Changer le secret invalide toutes les URI déjà présentes dans la boîte de chaque abonné.
83.3. Décoration¶
L’en-tête et le pied de page sont les list:member:regular:header et list:member:regular:footer de l’amont : une redéfinition list_template pour la liste, son domaine ou le site l’emporte, et sinon le list-member-regular-{header,footer}.<lang>.body livré dans le TEMPLATE_DIR de [pepsi] est utilisé, la langue du membre d’abord et en en repli. L’en-tête livré est vide et le pied de page livré est la mention « To unsubscribe … » de l’amont ; une redéfinition avec une URI vide signifie aucun. Un numéro de résumé n’est jamais décoré, puisqu’il porte son propre en-tête et son propre pied de page.
Le pied de page est ajouté à la première partie ``text/plain`` située hors de tout conteneur multipart/signed ou multipart/encrypted, et à rien d’autre. Ajouté à l’intérieur d’une partie signée il casse la signature, ajouté à un PDF il le corrompt : un message sans partie de ce genre est donc remis sans décoration plutôt qu’abîmé. Une copie dont le corps n’a pas changé (seulement les en-têtes de désabonnement, par exemple) continue de partager l’unique corps que l’éclatement a stocké.
avoid-duplicates signale une copie lorsque le membre figurait déjà dans le To ou le Cc du message et a conservé malgré tout sa copie de liste. Une telle copie porte X-Pepsi-List-Copy: yes, pour que le lecteur voie pourquoi il en a deux.
83.4. Deux invariants¶
Les enregistrements frères commencent ici, jamais en tête de pipeline. Rentrer à init relancerait la vérification ARC et repasserait par le routeur, ce qui explose de façon combinatoire sur une liste chapeau.
Les préférences personnelles d’un membre ne reconfigurent pas la remise de liste. Pepsi superpose automatiquement les surcharges pepsi.settings par adresse (voir Configuration), et l’unique destinataire d’un enregistrement frère est un membre. La surcharge d’absence ou de langue de ce membre n’a pas à changer les cibles de cette étape : un NEXT_STAGE qui en serait tiré pourrait acheminer la copie en contournant la signature. Aussi NEXT_STAGE, les options [pepsi-list] et le TEMPLATE_DIR de [pepsi] sont-ils lus dans la configuration globale du site, qu’aucune surcharge de configuration domain: ou address: ni aucune ligne pepsi.settings n’atteint, et la langue du membre vient du descripteur écrit par l’éclatement. Rien n’est repris de la surcouche.
83.5. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-list-deliver et NEXT_STAGE (obligatoire : la queue de signature ; pepsi-setup refuse un relais). Tout ce dont l’étape a besoin par ailleurs, c’est le descripteur de membre écrit par l’éclatement et les attributs propres de la liste, plus [pepsi-list] BASE_URL et UNSUBSCRIBE_SECRET pris dans la section du serveur.
83.6. State¶
Entrées :
state.list(l’identifiant de liste, la langue du membre, son numéro de série de désabonnement et l’indicateur de doublon) ainsi que l’uniquercpt_tode l’enregistrement, qui fait autorité sur l’adresse.Sorties : un bloc d’en-têtes et un corps réécrits. Aucun
staten’est modifié.Transitions : avancer vers
NEXT_STAGE, ou terminer (supprimer) une copie dont la liste a été supprimée après l’éclatement, puisqu’il ne reste personne à qui rendre compte.
83.7. Voir aussi¶
Listes de diffusion, pepsi-stage-list-post, pepsi-stage-dkim-sign, pepsi-list, pepsi-stage-list-deliver(1).