84. pepsi-stage-list-command

S’abonner, se désabonner et confirmer par e-mail ; transfert du courrier `-owner`.

84.1. Rôle

pepsi-stage-list-command traite tout ce qu’une liste de diffusion fait par courrier, hormis un message de liste : les sept commandes par e-mail, les deux flux d’abonnement et le transfert -owner. Référence : pepsi-stage-list-command(1).

Une phrase 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.

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.

84.2. Adresses

Il y a sept adresses, et les cinq premières ne sont pas analysées du tout : -join/-subscribe deviennent un join synthétique (l’objet et le corps ne sont jamais lus, et aucun courrier de résultats n’est envoyé), -leave/-unsubscribe deviennent de même un leave synthétique, et -confirm+<token> devient un confirm synthétique dont le jeton est pris dans l”adresse et jamais dans le message. -request est celle dont l’objet et le corps sont analysés. -owner n’est pas une commande du tout : le courrier qui lui est adressé est transféré à tous les propriétaires et modérateurs et n’atteint jamais l’analyseur. C’est le comportement d’amont, et il importe, car un message aux propriétaires dont l’objet se lit par hasard unsubscribe doit atteindre un humain et non exécuter une commande.

84.3. Commandes

confirm, echo, end (alias stop), help, join (alias subscribe), leave (alias unsubscribe) et who. 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 une réponse qui les distinguerait révélerait quels jetons existent.

  • ``leave`` ne prend aucun argument. join address= coûte à l’adresse nommée un message de confirmation et n’abonne personne ; un leave address= équivalent permettrait à un From: 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 du From:, avec repli sur l’expéditeur d’enveloppe seulement lorsque From: 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 un join nu), 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 indiquerait à 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. Principaux et confiance accordée à chacun traite les membres, propriétaires et modérateurs de listes comme hostiles au-delà de leurs propres listes, et ces trois règles maintiennent un message de commande dans cette borne.

84.4. Analyse

L’étape 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. 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 en rien, car exécuter des commandes depuis du HTML est un endroit où se montrer serviable est une décision de sécurité. Il n’y a aucun traitement des citations, des signatures ni des -- ; chaque jeton est mis en minuscules ; les lignes vides sont ignorées. Un premier mot inconnu est réessayé après avoir retiré exactement un mot, ce qui constitue tout le mécanisme Re: et n’est délibérément pas un retrait générique de préfixe (Fwd: help me exécuterait sinon help). Une commande qui arrête achève la passe, et le reste est signalé comme non traité. Avant tout cela, un message portant Precedence: bulk|junk|list sans X-Ack: yes est rejeté silencieusement.

Deux de ces règles ressemblent à des bogues et n’en sont pas : le nouvel essai retire un mot et pas davantage, et le plafond compte des lignes et non des commandes. Un message de onze lignes vides suivies de help n’exécute donc rien et signale le help comme ignoré. Augmenter MAX_COMMAND_LINES est le remède à « mon client de messagerie a mis un bloc d’en-têtes devant ma commande », pas une détection des citations.

84.5. La réponse

L’étape répond par 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 d’origine n’est jamais joint. Le From: d’un message de commande est falsifiable : un courrier de résultats part donc vers une adresse qui n’a peut-être rien envoyé, et joindre l’original ferait de cette étape un amplificateur de rétrodiffusion. Pour un expéditeur qui n’a pas réussi SPF ou DMARC, les résultats ne citent rien non plus de ce que cet expéditeur a écrit : aucun détail de l’original, des décomptes au lieu des lignes non traitées et ignorées, et pas d”echo de ses arguments (Les processus de notification des fournisseurs envoient du courrier contrôlé par l’attaquant).

84.6. 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 : quiconque en devine un peut 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. Supprimer un jeton emporte avec lui l’état de son flux, de sorte qu’une confirmation rejouée ne trouve rien.

84.7. Configuration

[stage-<name>] : PROGRAM = pepsi-stage-list-command, RESPONSE_STAGE (obligatoire : la queue de signature, et non l’étape de remise de liste, qui n’accepte que la copie d’un membre issue de l’éclatement et perdrait une notification), NEXT_STAGE (obligatoire : où va le courrier -owner une fois réadressé ; jamais le routeur de listes), MAX_COMMAND_LINES (10 par défaut ; 0 est refusé) et REQUIRE_AUTHENTICATED (désactivé par défaut ; lorsqu’il est activé, le courrier de résultats et les avis du répondeur automatique ne partent que vers un expéditeur qui a réussi SPF ou DMARC). Le BOUNCE_STAGE facultatif est l’endroit où un message destiné à une liste supprimée entre-temps est transformé en DSN ; sans lui, un tel message est mis en échec. pepsi-setup vérifie les deux cibles, ainsi que l’installation de la copie anglaise de chacun des 28 modèles d’avis de liste, puisque chaque langue se replie sur elle.

84.8. State

  • Entrées : state.list, écrit par pepsi-stage-list : l’identifiant de liste, le rôle que l’adresse désignait et un éventuel jeton -confirm.

  • Sorties : des messages de réponse et de notification injectés ; le message de commande lui-même est consommé.

  • Transitions : achèvement (un message de commande reçoit une réponse, il n’est pas transféré) ou passage à l’étape suivante pour le transfert -owner.

84.9. Voir aussi

Listes de diffusion, pepsi-stage-list, pepsi-stage-list-post, pepsi-list, pepsi-stage-list-command(1).