95.1.23. pepsi-stage-list-command¶
subscribe, unsubscribe and confirm by e-mail
- Section du manuel:
1
95.1.23.1.1. Nom¶
pepsi-stage-list-command - l’étape de commandes des listes de diffusion du pipeline Pepsi.
95.1.23.1.2. Synopsis¶
pepsi-stage-list-command [GLOBAL-OPTIONS] worker
95.1.23.1.3. Description¶
pepsi-stage-list-command est un programme d’étape exécuté par pepsi-dispatch(1). Il traite tout ce qu’une liste de diffusion fait par courrier, en dehors des contributions : les sept commandes par e-mail, les deux flux d’abonnement et le transfert -owner.
La phrase qui gouverne toute l’étape :
Le seul chemin qui ajoute une adresse sans que cette adresse ait prouvé qu’elle veut y être est un pre_verified et pre_confirmed explicite, émis par un client REST authentifié ou par la ligne de commande.
Rien dans cette étape ne peut poser l’un ou l’autre de ces indicateurs. Un message n’est pas un client authentifié : un join demande donc toujours confirmation à l’adresse nommée, ou refuse.
95.1.23.1.4. Adresses¶
Il y a sept adresses, et les cinq premières ne sont pas analysées du tout :
Adresse |
Ce qui se passe |
|---|---|
|
un |
|
jamais lus, et aucun courrier de résultats n’est envoyé |
|
un |
|
|
|
un |
|
le Subject et le corps sont analysés |
|
pas du tout une commande : transféré à chaque propriétaire et modérateur |
Le courrier -owner n’atteint jamais l’analyseur, ce qui est le comportement d’amont et a son importance : un message aux propriétaires dont le Subject se trouve être unsubscribe doit atteindre un humain, pas exécuter une commande.
95.1.23.1.5. Commandes¶
|
Confirmer une demande en attente à l’aide de son jeton. |
|
Renvoyer les arguments en écho, pour les tests. |
|
Arrêter le traitement des commandes (alias : |
|
Afficher la liste des commandes, ou l’aide d’une commande. |
|
S’abonner (alias : |
|
Se désabonner (alias : |
|
Afficher la liste des membres, si vous êtes autorisé à la voir. |
Trois d’entre elles portent une décision de sécurité et non de mise en forme :
``confirm`` arrête toujours le traitement, de sorte qu’un jeton qu’un client de messagerie répète plus bas dans le même message en le citant n’est jamais exécuté une seconde fois. Un jeton qui ne correspond pas reçoit la même réponse qu’un jeton expiré, car les distinguer serait un oracle indiquant quels jetons existent.
``leave`` ne prend aucun argument.
join address=coûte à l’adresse nommée un message de confirmation et n’abonne personne ; unleave address=équivalent permettrait à unFrom:falsifié de désabonner un inconnu sans plus. L’adresse propre de l’expéditeur doit en outre être vérifiée. « L’expéditeur » est la première adresse duFrom:, avec repli sur l’expéditeur d’enveloppe seulement lorsqueFrom:n’en nomme aucune, et c’est une seule et même adresse d’un bout à l’autre : celle dont la vérification est contrôlée est celle qui est retirée (et celle qu’abonne unjoinnu), jamais un expéditeur d’enveloppe qui en diffère.``who`` dépend de
member_roster_visibility, et une demande non autorisée est refusée et non satisfaite par une liste vide. Une réponse vide est indiscernable d’une liste sans membres, ce qui indique à un collecteur d’adresses que l’adresse vaut un nouvel essai.
Quiconque écrit à ces adresses est un expéditeur distant, et un From: falsifié ne coûte rien ; le chapitre modèle de menace du manuel de Pepsi (« Principals and how far each is trusted ») traite les membres, propriétaires et modérateurs de listes comme hostiles au-delà de leurs propres listes, et ces trois règles sont ce qui maintient un message de commande dans cette borne.
95.1.23.1.6. Analyse¶
L’analyseur reproduit les règles de tolérance d’amont, parce qu’il existe vingt ans d’instructions du type « envoyez le mot HELP à… » :
Une commande d’adresse l’emporte d’emblée (voir le tableau ci-dessus).
Le
Subject:est la première ligne de commande, décodée selon la RFC 2047 puis ramenée à l’ASCII.Le corps ne contribue que par sa première partie ``text/plain``, et seulement par ses MAX_COMMAND_LINES premières lignes. Un message sans partie en texte brut ne contribue rien : exécuter des commandes tirées du HTML est un domaine où se montrer serviable est une décision de sécurité.
Il n’y a aucun traitement des citations, des signatures ni de
--.Chaque jeton est mis en minuscules ; les lignes vides sont sautées en silence.
Un premier mot inconnu est réessayé après avoir retiré exactement un mot. C’est là tout le mécanisme de
Re:, et ce n’est délibérément pas un suppresseur de préfixes général : avec un tel suppresseur,Fwd: help meexécuteraithelp.Une commande qui s’arrête met fin à l’exécution ; le reste est signalé comme non traité.
Avant tout cela, un message portant
Precedence: bulk,junkoulistsansX-Ack: yesest écarté en silence.
Deux de ces règles ressemblent à des bogues et n’en sont pas. Le nouvel essai de la règle 6 retire un mot et pas davantage. Et le plafond de la règle 3 compte des lignes et non des commandes : onze lignes vides suivies de help n’exécutent donc rien et signalent le help comme ignoré. Le remède à « mon client de messagerie a mis un bloc d’en-têtes devant ma commande » consiste à augmenter MAX_COMMAND_LINES, pas à détecter les citations.
95.1.23.1.7. La réponse¶
La réponse est un courrier de résultats à la forme d’amont : un préambule, les détails du message d’origine, les résultats, les lignes non traitées et ignorées, puis « - Done. »
Le message original n’est jamais joint. Le From: d’un message de commande est falsifiable, de sorte qu’un courrier de résultats part vers une adresse qui n’a peut-être rien envoyé ; joindre l’original ferait de cette étape un amplificateur de backscatter. Pour la même raison, un expéditeur qui n’a pas réussi SPF ou DMARC (et n’a pas soumis localement) reçoit un courrier de résultats qui ne cite rien de ce qu’il a écrit : les From:, Subject:, Date: et Message-ID: de l’original sont omis, les lignes non traitées et ignorées sont remplacées par leur nombre, et echo ne répète pas ses arguments. Sinon, un faussaire pourrait faire remettre par la liste un texte de son choix à un tiers.
95.1.23.1.8. Jetons de confirmation¶
Un jeton, ce sont 256 bits d’aléa en base32. Il est aussi la sous-adresse -confirm+<token> et le dernier segment de chemin de l’URL de confirmation : en deviner un revient donc à achever l’abonnement de quelqu’un d’autre.
Sa durée de vie dépend de qui l’on attend : un jeton détenu par un modérateur vit 180 jours, tout le reste trois. Un modérateur peut être en congé, et une demande d’abonnement expirée en trois jours serait perdue en silence au lieu d’être tranchée.
Les jetons expirés sont balayés par pepsi-list tasks --once, qu’une minuterie systemd exécute ; voir pepsi-list(1). Supprimer un jeton supprime avec lui l’état de son flux, ce qui fait qu’une confirmation rejouée ne trouve rien.
95.1.23.1.9. Configuration¶
- RESPONSE_STAGE (obligatoire)
L’endroit où les réponses et les avis de confirmation sont injectés. La queue de signature, et non l’étape de remise de liste : pepsi-stage-list-deliver(1) n’accepte que la copie d’un membre issue de l’éclatement et fait échouer tout le reste, de sorte qu’un avis envoyé là ne part jamais. pepsi-setup(1) refuse la mauvaise valeur.
- NEXT_STAGE (obligatoire)
L’endroit où va le courrier
-ownerune fois réadressé aux propriétaires de la liste. pepsi-setup refuse une valeur qui pointe de nouveau vers le routeur, ce qui réacheminerait le transfert et bouclerait.- MAX_COMMAND_LINES (par défaut 10)
Le nombre de lignes du corps que lit l’analyseur (le
[mailman] email_commands_max_linesd’amont). Compte des lignes, et non des commandes. pepsi-setup refuse0.- REQUIRE_AUTHENTICATED (par défaut no)
Ne répondre à un message de commande que lorsque le domaine d’enveloppe de son expéditeur a réussi SPF ou que le domaine de son
From:a réussi DMARC. Les commandes s’exécutent encore là où elles le peuvent ; ce qui est retenu, c’est le courrier de résultats et les avis du répondeur automatique, qui partent vers une adresse que personne n’a vérifiée. Par défaut, seul unfailnet les retient (les règles RFC 3834 partagées depepsi_common::autoreply), de sorte qu’un expéditeur d’un domaine qui ne publie aucun de ces enregistrements reçoit une réponse. Avec l’option activée, un tel expéditeur n’a jamais de nouvelles, et un expéditeur falsifié ne peut pas faire écrire l’adresse de commande de la liste à une adresse choisie par le faussaire.- BOUNCE_STAGE (facultatif)
Où va le DSN d’un message dont la liste a été supprimée après que le routeur l’a acheminé (voir Erreurs et réessais). Sans elle, un tel message est mis en échec.
pepsi-setup refuse aussi cette section lorsque l’un des 28 modèles d’avis de liste manque en anglais (<name>.en.body dans le TEMPLATE_DIR de [pepsi]) : une liste dont la langue n’a pas de modèle se replie sur en.
95.1.23.1.10. État¶
Entrées : state.list.id et state.list.role (écrits par pepsi-stage-list(1)), et state.list.token pour une adresse -confirm.
Sorties : aucune. Tout ce que cette étape modifie est un enregistrement de la base de données.
Transitions : achèvement (tous les chemins de commande) ou passage à NEXT_STAGE (le transfert -owner).
95.1.23.1.11. Commandes¶
- worker
Exécuté comme un worker persistant de pepsi-dispatch(1), lisant les identifiants de message sur l’entrée standard.
95.1.23.1.12. 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.23.1.13. Erreurs et réessais¶
Un message qui nomme une liste qui n’existe plus est signalé à l’expéditeur via le BOUNCE_STAGE de l’étape (un DSN par destinataire, indiquant que la liste de diffusion n’existe plus), ou mis en échec lorsque l’étape n’en a pas ; un message à expéditeur nul est au contraire abandonné. Un message que l’analyseur MIME refuse est mis en échec immédiatement. Toute autre erreur est une défaillance de l’hôte et est réessayée avec un back-off jusqu’à MAX_LIFETIME (voir pepsi-dispatch(1)).
La réservation du délai de grâce pour le courrier de résultats est enregistrée avant que list_command_commit ne valide les commandes et le courrier ; elle est donc indexée sur le jeton de file du message : un message réessayé après l’échec de cette validation peut renvoyer ses résultats plutôt que de s’entendre dire qu’il a déjà reçu une réponse aujourd’hui.
95.1.23.1.14. 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 ne s’analyse pas (par exemple un RESPONSE_STAGE manquant). Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.
95.1.23.1.15. Exemples¶
[stage-list-command]
PROGRAM = pepsi-stage-list-command
RESPONSE_STAGE = dkim-sign
NEXT_STAGE = local
MAX_COMMAND_LINES = 10
95.1.23.1.16. Voir aussi¶
pepsi-list(1), pepsi-stage-list(1), pepsi-stage-list-post(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
95.1.23.1.17. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.