95.1.22. pepsi-stage-list-deliver¶
finalise one member’s copy of a mailing-list post
- Section du manuel:
1
95.1.22.1.1. Nom¶
pepsi-stage-list-deliver - l’étape de remise par membre du pipeline de listes de diffusion de Pepsi.
95.1.22.1.2. Synopsis¶
pepsi-stage-list-deliver [OPTIONS-GLOBALES] worker
95.1.22.1.3. Description¶
pepsi-stage-list-deliver est un programme d’étape exécuté par pepsi-dispatch(1). pepsi-stage-list-post(1) a déjà produit un enregistrement par destinataire, et cette étape 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.
Trois choses se produisent :
``List-Unsubscribe`` est achevé avec l’URI
https:en un clic propre à ce membre, à côté de la formemailto:, etList-Unsubscribe-Post: List-Unsubscribe=One-Clickest ajouté (RFC 8058).Le message est décoré avec l’en-tête et le pied de page de la liste, dans la langue du membre, lorsque le
personalizede la liste vautindividualoufull. Un numéro de résumé n’est jamais décoré : il porte son propre en-tête et son propre pied de page.``To:`` est réécrit pour nommer le membre, pour
fulluniquement. Lepersonalize_tod’amont est une opération vide pourindividual, et celui-ci aussi.
Une copie signalée par avoid-duplicates porte X-Pepsi-List-Copy: yes, pour que le lecteur voie pourquoi il en a deux. Une telle copie va à un membre qui figurait déjà dans le To ou le Cc du message et a conservé malgré tout sa copie de liste.
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(1), et non vers un relais, et pepsi-setup refuse l’inverse. Amont dit la même chose dans le commentaire qui retire arc-sign de son propre pipeline.
95.1.22.1.4. 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. Trois conséquences :
le jeton ne voyage jamais entre les étapes, car celle-ci détient le secret et le calcule 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 ;et 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é.
95.1.22.1.5. 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, résolus comme tout autre avis de liste : une redéfinition list_template pour la liste, puis pour son domaine, puis pour le site, et sinon les list-member-regular-header.<lang>.body et list-member-regular-footer.<lang>.body livrés dans le TEMPLATE_DIR de [pepsi], la langue du membre étant choisie d’abord et en servant de repli. L’en-tête livré est vide et le pied de page livré est la mention « To unsubscribe send an email to … » de l’amont. Une redéfinition avec une URI vide (ou qui répond 404) signifie aucun en-tête ou pied de page, et un texte qui ne rend que des espaces n’ajoute rien. Un worker réutilise pendant une minute une redéfinition récupérée, afin qu’une contribution ne la récupère pas une fois par membre. Un modèle livré qui existe mais ne peut être lu ou rendu est une erreur, et la copie est réessayée plutôt qu’envoyée sans le pied de page que le propriétaire a configuré.
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é.
Seule une copie dont le corps a changé reçoit son propre corps. La paire de désabonnement, le tampon de copie et la réécriture du To: sont des modifications d’en-tête, et une copie qui n’a reçu que celles-ci continue de référencer l’unique corps que l’éclatement a stocké pour tous les membres.
95.1.22.1.6. 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 redéfinitions pepsi.settings par adresse, et l’unique destinataire d’un enregistrement frère est un membre, dont la redéfinition d’absence ou de langue n’a pas à changer les cibles de cette étape : un NEXT_STAGE qui en serait tiré pourrait faire passer la copie à côté de la signature. NEXT_STAGE, les options [pepsi-list] et [pepsi] TEMPLATE_DIR sont donc lus dans la configuration globale du site, qu’aucune redéfinition de configuration domain: ou address: ni aucun enregistrement pepsi.settings n’atteint, et la langue du membre vient du descripteur que l’éclatement a écrit. Rien n’est pris dans la surcouche.
95.1.22.1.7. Configuration¶
- NEXT_STAGE (obligatoire)
La queue de signature. pepsi-setup refuse un relais ici.
Tout le reste dont cette étape a besoin est le descripteur de membre que l’éclatement a écrit et les attributs propres de la liste ; [pepsi-list] BASE_URL et UNSUBSCRIBE_SECRET sont lus dans la section du site.
95.1.22.1.8. État¶
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’unique rcpt_to de l’enregistrement, qui fait autorité sur l’adresse.
Sorties : un bloc d’en-têtes et un corps réécrits. Aucun state n’est modifié.
Transitions : passage à NEXT_STAGE, ou fin (suppression) d’une copie dont la liste n’existe plus.
95.1.22.1.9. Commandes¶
- worker
Exécuté comme un worker persistant de pepsi-dispatch(1), lisant les identifiants de message sur l’entrée standard.
95.1.22.1.10. Options globales¶
L’ensemble habituel : -c/–config, -L/–log, -v/–verbose, -h/–help et -V/–version, qui se comportent comme pour tout programme Pepsi ; voir pepsi-config(1).
95.1.22.1.11. Erreurs et réessais¶
Une copie dont la liste a été supprimée après l’éclatement est abandonnée, avec un avertissement dans le journal : le propriétaire a supprimé la liste, une copie remise maintenant porterait un lien de désabonnement vers rien, et il ne reste personne à qui le signaler.
Une copie qui ne peut être analysée pour la décoration est remise sans décoration, avec un avertissement. L’éclatement a construit ces octets à partir d’un message qu’il avait analysé ; ce n’est donc pas le fait de l’expéditeur et un réessai ne peut rien y changer ; la copie porte toujours les en-têtes
List-*propres à la liste (y compris le désabonnementmailto:), et l’abandonner ferait perdre son courrier au membre.Une ligne sans descripteur de membre est mise en échec immédiatement.
Toute autre erreur (la base de données, un modèle) est réessayée avec un back-off jusqu’à MAX_LIFETIME (voir pepsi-dispatch(1)). Une copie finalement abandonnée est supprimée par pepsi-failure-bouncer(1), et non renvoyée en rebond, et ne compte donc jamais contre le membre.
95.1.22.1.12. Code de sortie¶
Le résultat de chaque message est rapporté à pepsi-dispatch(1) sur la ligne de statut du worker, et non par le code de sortie.
- 0
Le worker s’est exécuté jusqu’à la fermeture de son entrée standard.
- 1
Une erreur fatale s’est produite (configuration illisible, la base de données n’a pas pu être ouverte, ou l’entrée/sortie standard a échoué). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer : une section
[stage-*]qu’il sert,[pepsi-list]ou[pepsi]ne s’analyse pas (par exemple un NEXT_STAGE manquant). Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.
95.1.22.1.13. Exemples¶
[stage-list-deliver]
PROGRAM = pepsi-stage-list-deliver
NEXT_STAGE = dkim-sign
95.1.22.1.14. Voir aussi¶
pepsi-list(1), pepsi-stage-list-post(1), pepsi-stage-list(1), pepsi-stage-dkim-sign(1), pepsi-stage-arc(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
95.1.22.1.15. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.