11. Fonctionnalités prises en charge

Ce chapitre présente les fonctionnalités de niveau protocole et politique que Pepsi prend en charge, avec la RFC qui régit chacune : la machinerie SMTP et d’authentification, la cryptographie de bout en bout, et la surface d’exploitation qui entoure les deux. L”Index des RFC met en correspondance chaque RFC avec le code et la configuration ; les chapitres par programme indiquent quel programme réalise chaque fonctionnalité.

11.1. Réception SMTP entrante

pepsi-ingress est un serveur SMTP conforme aux normes (RFC 5321) avec ces extensions :

  • Sécurité du transport. En clair, mise à niveau STARTTLS (RFC 3207) et TLS implicite (RFC 8314, par exemple le port submissions 465) — sélectionnés par écouteur via MODE. Des écouteurs de soumission (RFC 6409, SUBMISSION = yes) peuvent être liés — voir Soumission de messages.

  • Transfert du corps du message. DATA classique et CHUNKING/BDAT (RFC 3030) pour les messages volumineux. BINARYMIME n’est pas annoncé, et un MAIL FROM portant BODY=BINARYMIME est refusé par 501 5.5.4.

  • Annonce et application de SIZE (MAX_MESSAGE_SIZE ; taille excessive → 552).

  • PIPELINING et ENHANCEDSTATUSCODES.

  • 8BITMIME (RFC 6152) et SMTPUTF8 (RFC 6531) — voir Contenu internationalisé et 8 bits.

  • DSN (RFC 3461) — voir Notifications d’état de remise.

  • RRVS (RFC 7293) — voir Adresses recyclées.

  • REQUIRETLS (RFC 8689), sur les sessions protégées par TLS — voir Exiger TLS.

  • SMTP AUTH (RFC 4954) pour la soumission — voir Authentification du client.

  • Politique d’acceptation : le courrier n’est accepté que pour ACCEPTED_DOMAINS (les autres sont rejetés comme relayage avec 550) ; la boîte aux lettres <Postmaster> sans domaine est toujours acceptée (RFC 5321 §4.5.1) ; les destinataires qui sont des jetons SRS valides sont décodés en sens inverse et relayés (voir Sender Rewriting Scheme (SRS)).

  • Durabilité : le client ne reçoit 250 qu’une fois la ligne validée en base ; si la base de données est indisponible, le client reçoit un 451 transitoire et réessaie.

11.2. En-têtes de trace

L’ingress ajoute en tête un en-tête Received: RFC 5321 §4.4 à chaque message avant l’authentification (de sorte que le sceau ARC le couvre). La clause with note le type de transmission conformément à la RFC 3848 : SMTP, ESMTP, ESMTPS, ESMTPA ou ESMTPSA. L”ESMTPA nu, authentifié mais non sur TLS, est la socket UNIX de soumission locale. Une clause for nomme le destinataire pour les transactions à destinataire unique.

11.3. Authentification du client

Chaque écouteur peut authentifier le client connecté et marquer son courrier comme d’origine locale (ce qui lui permet de relayer plus loin vers n’importe quel domaine et appose ESMTPSA dans la trace Received:). Une session est authentifiée lorsque l’un quelconque de quatre mécanismes par écouteur réussit :

  • l’IP du pair figure dans le MYNETWORKS de l’écouteur (de confiance d’emblée ; les adresses au nom desquelles un tel réseau peut envoyer sont liées par SENDER_MAP, et une entrée hors boucle locale que la table ne couvre pas est refusée au démarrage) ;

  • un échange SMTP AUTH réussit (RFC 4954, PLAIN/LOGIN), vérifié auprès d’un backend SASL configuré (SASL_TYPE/SASL_PATH ; la socket auth-client de Dovecot aujourd’hui). AUTH n’est annoncé et accepté que via TLS : une tentative en clair est refusée par 504 5.5.4, le code que la RFC 4954 §4 prescrit pour un mécanisme qui « exige une couche de chiffrement » (le §1 déprécie l’ancien 538) ;

  • un certificat client TLS présenté est une clé épinglée (TLS_AUTH_CLIENT) ou se valide, contraintes et révocation comprises, jusqu’à une AC configurée (TLS_AUTH_CLIENT_CA), et SENDER_MAP le lie à ses adresses (un certificat non lié n’authentifie rien) ;

  • le pair d’une socket UNIX est identifié par SO_PEERCRED (AUTH_PEERCRED, la socket de soumission locale) et son login est associé à au moins une adresse. Celui-ci porte un nom d’utilisateur, il alimente donc la même application de USERNAME_MAP qu’une session SASL.

Ceci est distinct de l”Authentification à la bordure ci-dessous, qui vérifie le message (SPF/DKIM/DMARC) indépendamment de la manière dont le client lui-même s’est authentifié, ou du fait qu’il l’ait fait. Voir pepsi-ingress.

11.4. Soumission de messages

Un écouteur marqué SUBMISSION = yes se comporte comme un Message Submission Agent (RFC 6409) plutôt que comme un MX :

  • l’authentification est obligatoire — un MAIL FROM non authentifié est refusé par 530 5.7.0 (donc l’indicateur exige l’un des mécanismes d’authentification client ci-dessus, et TLS sur tout écouteur qui n’est pas une socket locale du domaine UNIX) ; et

  • des corrections de soumission sont appliquées à chaque message accepté : un Date: manquant (§8.2) et un Message-ID: manquant (§8.3) sont ajoutés avant le stockage du message ; et

  • l”application de l’identité de soumission (§6) via USERNAME_MAP : le MAIL FROM d’enveloppe et l’en-tête From: doivent être des adresses que l’utilisateur authentifié a le droit d’utiliser (sinon 550), et un From: autorisé qui diffère de l’identité canonique de l’utilisateur obtient un en-tête Sender: qui la nomme (§8.1). Chaque boîte aux lettres From: est lue par un analyseur qui saute les chaînes entre guillemets et les commentaires RFC 5322, si bien qu’un commentaire ne peut pas masquer l’adresse réellement utilisée (En-têtes From ambigus vérifiés comme une adresse et affichés comme une autre). Un message sans From:, avec plus d’un, avec seulement un groupe ou avec une boîte aux lettres dépourvue d’adresse complète est refusé (550 5.6.0), de même qu’un From: dont le nom d’affichage nomme une autre adresse que la sienne, car de nombreux clients n’affichent que le nom.

L’option n’a aucun effet sur un écouteur MX. Un utilisateur shell local et la L’identité de submission indiquent ce que cette liaison protège et ne protège pas.

11.5. Authentification à la bordure

Avant de stocker un message, l’ingress l’authentifie, afin que le destinataire final puisse encore voir le verdict que Pepsi a atteint à la bordure (la redirection cassera les signaux SPF/DKIM originaux) :

  • SPF (RFC 7208) sur l’identité MAIL FROM en utilisant l’IP du client.

  • Vérification de signature DKIM (RFC 6376 / RFC 8463).

  • Évaluation DMARC (RFC 7489), avec application au moment SMTP (DMARC_ENFORCE → 550 sur un échec certain sous une politique quarantine/reject ; l’assistant l’écrit pour une nouvelle installation) et une exception ARC pour les réexpéditeurs et listes nommés dans ARC_TRUSTED_SEALERS (une chaîne valide scellée en dernier par l’un d’eux est acceptée, notée dans state.auth.arc_override). L’authentification est sinon fail-open : une erreur DNS ou d’analyse est notée et le courrier accepté.

  • iprev / FCrDNS (RFC 8601) : vérifie si l’enregistrement PTR du client confirme en sens direct son IP.

  • Un en-tête Authentication-Results (RFC 8601) notant tout ce qui précède, estampillé du nom d’hôte de l’ingress comme authserv-id.

L’autre moitié de DMARC, ce sont les rapports que d’autres destinataires envoient au sujet du courrier sous nos domaines. pepsi-stage-dmarc-report lit les rapports agrégés (RFC 7489 §7.2) envoyés à dmarc-reports@<domain>, c’est-à-dire l’adresse rua= de l’enregistrement que suggère pepsi-setup. À partir des rapports authentifiés, pepsi-setup check, pepsi-status et la console disent si chaque source d’envoi était alignée, et donc si p=reject est sans danger, ou quelles sources il refuse.

Avec DMARC_ENFORCE, DMARC est évalué par domaine d’auteur (au plus MAX_DMARC_AUTHOR_DOMAINS, 10), si bien qu’une seconde boîte aux lettres From: ne peut pas faire passer une contrefaçon derrière la première. Le courrier venu de l’extérieur est aussi nettoyé à cette frontière : un message avec plus d’un champ From: est refusé, et un champ Bcc: est retiré (un « répondre à tous » citerait sinon du texte déchiffré à une adresse que l’attaquant y a inscrite). Le courrier soumis perd aussi son champ Bcc:, de sorte qu’un client qui en laisse un ne peut pas révéler les destinataires cachés. Un From: dont le nom d’affichage nomme une autre adresse est marqué par X-Pepsi-Warning: display-name-claims-other-address, et celui qui porte des caractères de contrôle bidirectionnels ou invisibles est marqué par X-Pepsi-Warning: from-has-bidi-or-invisible-characters ; tout X-Pepsi-Warning que l’expéditeur a écrit est retiré au préalable. Un From: qui se lit de plus d’une façon ou nomme des boîtes aux lettres dans plusieurs domaines (from-ambiguous), et un Sender: dans un domaine servi que personne n’a authentifié (served-sender-not-authenticated), sont marqués et étiquetés [external] comme un From: servi contrefait. Un domaine From: qui ressemble à un domaine servi (from-domain-resembles-served-domain) et une pièce jointe dont le nom de fichier cache des caractères bidirectionnels ou invisibles (attachment-name-has-bidi-or-invisible-characters) ne sont marqués que dans l’en-tête. L’adversaire auquel cela répond est Un expéditeur distant.

11.6. Authenticated Received Chain (ARC)

L’étape pepsi-stage-arc implémente ARC (RFC 8617). Elle vérifie toute chaîne ARC entrante et scelle le message en tant que notre ADMD en ajoutant en tête un ensemble ARC-Authentication-Results / ARC-Message-Signature / ARC-Seal, signé avec l’unique ARC_ALGORITHM (ARC permet une signature par saut). Cela permet à un destinataire en aval de faire confiance au verdict de bordure après que la redirection a cassé l’alignement SPF/DKIM. Le scellement est fail-open. Comme ARC préserve l’authentification d’un expéditeur en amont à travers le saut de redirection, il ne s’applique qu’au courrier que Pepsi reçoit. Les soumissions d’origine locale (state.local_origin) sont ignorées, car l’étape de signature DKIM les authentifie comme domaine auteur. Le pipeline généré place donc ARC sur la branche entrante, après la scission state.local_origin.

11.7. Sender Rewriting Scheme (SRS)

L’étape pepsi-stage-srs réécrit l’expéditeur d’enveloppe en une adresse locale d’un SRS_DOMAIN contrôlé par Pepsi qui encode en HMAC l’expéditeur original (le MAC tronqué est encodé en base32, RFC 4648), de sorte que SPF réussit au saut suivant. L’expéditeur nul et une adresse déjà dans le domaine SRS sont laissés inchangés ; une adresse déjà SRS est re-signée sous la forme compacte SRS1. L’ingress effectue le sens inverse : un rebond renvoyé à une adresse SRS valide est vérifié et relayé vers l’expéditeur original, tandis qu’un jeton falsifié ou expiré est rejeté (550).

Une copie qu’un alias ou un ~/.forward envoie hors du site reçoit à la place une adresse de retour de réexpédition (fwd+<sealed>=<tag> dans le domaine SRS), qui scelle l’expéditeur d’origine et l’adresse que l’expéditeur a utilisée. Un rapport distant au sujet d’une telle copie reçoit une réponse, il n’est pas relayé : l’entrée ne l’accepte que de l’expéditeur nul, le journalise pour l’opérateur et l’abandonne, et l’étape de rebond envoie à l’expéditeur d’origine le propre DSN de Pepsi au sujet de l’adresse qu’il a utilisée. Ainsi, la cible de la réexpédition, la réponse de l’hôte qui se trouve derrière et, pour le courrier arrivé chiffré, le texte en clair restent chez l’utilisateur (Les adresses de retransmission dans les rapports de remise).

11.8. Chiffrement et signature de bout en bout

pepsi-stage-encrypt chiffre un message soumis localement pour chaque destinataire, en OpenPGP (PGP/MIME, RFC 3156) ou en S/MIME (CMS, RFC 8551 / 5083), signé avec la clé propre de l”auteur du From:. La signature est placée à l’intérieur du texte chiffré.

ENABLE_PEP (activé par défaut) est un préréglage de valeurs par défaut calqué sur le projet pretty Easy privacy : chaque expéditeur local d’un domaine servi obtient automatiquement une clé OpenPGP, un message n’est signé que lorsqu’il est chiffré (SIGN = encrypted-only), et le courrier en clair porte la clé de l’expéditeur dans un en-tête Autocrypt: mais aucune signature. Toute option écrite explicitement l’emporte toujours ; ENABLE_PEP = no rend la signature opportuniste et désactive la création automatique de clés.

Chaque destinataire chiffré obtient son propre texte chiffré sur sa propre ligne de file d’attente : aucun texte chiffré ne nomme les autres destinataires, et aucune clé de contenu n’est partagée entre destinataires. Ni un texte chiffré ni un en-tête Autocrypt-Gossip ne peut révéler un destinataire en Bcc, car le gossip ne nomme que les adresses de To: et Cc:. Seuls les destinataires sans clé partagent une ligne, car ils reçoivent tous le même traitement sans clé.

Les clés des destinataires proviennent du magasin de Gestion des clés, alimenté par la couche de découverte (WKD, VKS, DANE, LDAP, moisson depuis le courrier entrant). L’étape elle-même ne fait aucune E/S réseau : un destinataire dont la clé n’est pas en cache met le message en pause jusqu’à ce qu’un service de découverte règle la demande, et un destinataire ayant une entrée récente de cache négatif prend aussitôt le chemin sans clé.

Ce qu’il advient d’un destinataire sans clé est une question de politique : ON_NO_KEY vaut cleartext, secure-link ou bounce, et prend sa valeur par défaut d”ENCRYPT plutôt que d’en avoir une propre. ENCRYPT = required ne se dégrade jamais en clair, et aucune issue en clair n’est jamais silencieuse : chacune est journalisée et notée par destinataire dans state.crypto.out, avec le conteneur de contenu réellement employé et l’indication d’une éventuelle rétrogradation. Une recherche qui a échoué dans le DNS ne compte pas comme « pas de clé » là où l’issue serait le clair. Le message est alors différé ; lorsque le domaine répond pour ses serveurs de messagerie mais pas pour ses enregistrements de clés, il est envoyé au portail ou renvoyé en rebond à la place. Rien de cela n’a lieu si l’expéditeur a accepté le clair avec [clear-ok] dans l’objet ou par CLEAR_ON_DNS_FAILURE (Une recherche de clé qui échoue dans le DNS). Le conteneur S/MIME qu’obtient un correspondant est appris par pair (Quel conteneur S/MIME reçoit un correspondant).

L’étape s’exécute avant la signature DKIM, de sorte que DKIM couvre les octets réellement transmis ; voir Configuration pour comprendre pourquoi cet ordre n’est pas facultatif.

11.9. Déchiffrement et vérification côté serveur

pepsi-stage-decrypt en est la moitié entrante. Pour un message adressé à un destinataire que cet hôte sert, elle ouvre tout texte chiffré que le message porte, vérifie toute signature qu’il porte, note le verdict et retire tout indicateur de sécurité que l’expéditeur aurait falsifié. L’utilisateur lit du courrier ordinaire dans son client habituel, sans aucun greffon. L’exception est le courrier chiffré vers une clé que l’utilisateur a enregistrée depuis son propre client de messagerie (une clé sous garde du client, dont Pepsi ne détient jamais la moitié privée) : celui-ci est transmis sans être ouvert, pour que le client le déchiffre.

Elle ne s’exécute que pour les destinataires que cet hôte sert, et n’essaie même pas pour les autres. Le déchiffrement réécrit le corps, ce qui invalide la signature DKIM de l’expéditeur ; c’est sans conséquence pour un message sur le point d’être classé dans une boîte aux lettres ici, et ce ne l’est pas pour un message relayé plus loin. Un message comportant les deux sortes de destinataires est scindé, de sorte que la copie réacheminée soit celle qui est arrivée.

Le vocabulaire des verdicts est précis. valid signifie que la signature est saine et que la clé était ancrée, par une chaîne X.509 vers une autorité de certification configurée ou en tant que clé OpenPGP issue d’une source de découverte classée. valid-untrusted signifie saine avec une clé qui n’a pu être rattachée à rien, ce qui est l’état de la majeure partie du courrier signé du monde et n’est jamais rapporté comme valid. invalid, unverifiable et none complètent l’ensemble, et lorsqu’un message porte plusieurs signatures sur le même contenu, le pire d’entre eux l’emporte. (Une signature faite à l’extérieur du chiffré est une classe à part : elle ne répond du message que lorsque rien ne signe le texte en clair, et jamais mieux alors que valid-untrusted — voir pepsi-stage-decrypt.) Seul valid positionne state.signature_verified, dont pepsi-stage-check-whitelist fait dépendre une ligne de liste blanche. Une signature dont le From: protégé diffère du champ extérieur est rétrogradée plutôt que créditée à l’auteur extérieur (Les en-têtes protégés face aux en-têtes extérieurs), et ce qu’un verdict promet au lecteur est exposé dans Ce que signifie un indicateur de sécurité. Le verdict parvient au lecteur sous la forme des marques d’objet et, dans Outlook et Thunderbird, par une extension qui affiche le champ X-Pepsi-Crypto hors de la zone du message (Extensions pour clients de messagerie).

Les deux chemins d’échec remettent par défaut, conformément à la posture fail-open de Pepsi sur le SPF, le DKIM et le DMARC entrants : un message que nous n’avons pas pu ouvrir est remis toujours chiffré (l’utilisateur détient peut-être la clé dans son propre client), et une mauvaise signature est un verdict noté plutôt qu’un échec de remise (les listes de diffusion qui réécrivent les corps en produisent sur du courrier parfaitement légitime). Des routes de quarantaine et de rebond existent pour les déploiements qui les veulent. Le prix de ce choix par défaut est qu’une signature mauvaise ou invérifiable reste silencieuse dans l’objet (Réponses, brouillons et mailto transformant les clients en oracles de déchiffrement et de signature).

Le résultat parvient à l’utilisateur de deux façons : un en-tête X-Pepsi-Crypto à la grammaire documentée et, par défaut, un [decrypted][verified] ajouté en tête du Subject dans l’ordre d’imbrication. Pour la plupart des utilisateurs, c’est le seul signal qu’ils verront jamais. Les deux reposent sur la même discipline : chaque champ X-Pepsi-* et chacune de nos propres marques d’objet est retiré du courrier entrant avant que le nôtre ne soit ajouté. Un en-tête privé est falsifiable par définition, et ce retrait est toute la base sur laquelle on peut y croire (État de sécurité usurpé dans le corps ou les en-têtes du message, Des étiquettes de sécurité falsifiées dans le Subject contournent l’assainissement de la passerelle). Nos marques se placent tout au début, si bien qu’un client qui tronque un objet long les affiche encore (Des étiquettes de sécurité falsifiées dans le Subject contournent l’assainissement de la passerelle).

Le matériel de clé qu’un message porte (certificats de signataire S/MIME, parties application/pgp-keys, en-têtes Autocrypt) est lu en mémoire pour vérifier la signature de ce message-là, parce que la plupart du courrier signé porte le certificat qui l’a signé. Lorsque ce n’est pas le cas, le message se met en pause sur une demande de découverte plutôt que de bloquer sur un serveur de clés, de sorte que même le premier message d’un nouveau correspondant obtienne un verdict réel.

L’étape de déchiffrement n’en stocke rien. Tout l’apprentissage des clés de pairs est une étape à part entière, pepsi-stage-autocrypt-learn, placée après le verdict de spam. C’est ce placement qui rend applicable la règle du §5.3 d’Autocrypt Level 1, « ignorer les messages que le MUA croit être du spam » (LEARN_FROM_SPAM, désactivé par défaut). Un pipeline entrant sans cette étape vérifie parfaitement bien les signatures et n’apprend jamais la clé d’un correspondant.

Ce que l’étape de déchiffrement ouvre est déposé en clair, sauf si le destinataire a enregistré sa propre clé de client de messagerie. Dans ce cas, pepsi-stage-reencrypt, placée immédiatement avant la remise locale, le scelle avec cette clé une fois que toutes les étapes qui le lisent ont terminé. Une politique par destinataire (ON_NO_CLIENT_KEY) peut refuser le courrier d’un utilisateur qui n’a pas de telle clé plutôt que de le déposer lisible. Le courrier scellé de cette façon n’est lisible qu’avec cette clé de client, si bien que la perdre fait perdre le courrier déposé (Gestion des clés trop difficile : clients de messagerie de bout en bout sources d’erreurs ou inutilisés).

Avant l’une comme l’autre, pepsi-stage-defang retire du HTML d’un utilisateur qui l’a activé tout ce que ce HTML chargerait de lui-même depuis le réseau. Cela comprend le pixel espion qui signale une ouverture, et un <img src="... dans lequel une partie déchiffrée pourrait transporter son texte en clair. Les liens, les parties cid:, les images intégrées et tout ce que couvre une signature restent tels quels.

11.10. Gestion, découverte et publication des clés

Aucune des deux étapes cryptographiques ne fait d’E/S réseau propre. Toutes deux puisent dans un magasin de clés du schéma partagé, alimenté dans deux directions : par pepsi-keydisc, qui fait tourner une instance de service par méthode de découverte pour qu’un serveur de clés lent ne retarde personne, et par pepsi-stage-autocrypt-learn à partir du courrier qui arrive. Une étape qui a besoin d’une clé dont elle ne dispose pas valide ce qu’elle peut conserver, met le message en pause et met une demande en file ; le service qui répond libère, dans le même aller-retour, chaque message garé sur cette adresse.

  • Sources de découverte, chacune une consultation distincte exécutée simultanément avec son propre rang sur une échelle de confiance : le Web Key Directory (formes avancée et directe), DANE OPENPGPKEY (RFC 7929) et SMIMEA (RFC 8162) (acceptés seulement lorsque le bit AD du résolveur indique que la réponse a été validée par DNSSEC), le protocole VKS d’un serveur de clés vérificateur, et LDAP. Au-dessous de toutes sur l’échelle se trouvent les deux échelons qui ne sont pas des services de découverte et n’ont aucune instance. Le plus haut est le matériel moissonné dans le courrier entrant (certificats de signataire S/MIME, parties application/pgp-keys et en-têtes Autocrypt). Un échelon plus bas encore, tout en bas, se trouve la clé d’un tiers introduite par Autocrypt-Gossip: dans un message arrivé chiffré. Les deux sont écrits sur place par pepsi-stage-autocrypt-learn ; nommer l’un ou l’autre dans SOURCES est refusé.

  • Publication des clés de nos propres utilisateurs : les points de terminaison WKD servis par pepsi-httpd, les enregistrements OPENPGPKEY/SMIMEA imprimés par pepsi-keys et pepsi-setup, et le téléversement vers un serveur de clés vérificateur, par identité et uniquement sur demande ; pepsi-stage-vks-confirm répond au courrier de confirmation de ce serveur.

  • Garde. Le matériel privé est stocké enveloppé sous une clé de chiffrement de clés qui réside hors de la base de données, et n’est atteignable que par l’unique rôle de base sous lequel s’exécutent les étapes cryptographiques (Un chiffrement non authentifié des clés privées permet au détenteur du stockage d’altérer les clés) ; ces étapes détiennent donc toutes les clés conservées par le serveur pendant qu’elles analysent des entrées hostiles (Des appliances de messagerie stockent des secrets lisibles par tous ou non protégés).

  • Un cache négatif fait que seul le premier message vers ou depuis un correspondant inconnu doit jamais attendre.

Gestion des clés est le chapitre consacré à tout cela ; la référence des options est pepsi.conf(5).

11.12. Signature DKIM sortante

L’étape pepsi-stage-dkim-sign ajoute en tête des signatures DKIM (RFC 6376) sous le SIGNING_DOMAIN ou le domaine du From: du message. Par défaut, elle ajoute à la fois une signature RSA (2048 bits par défaut) et une Ed25519 (RFC 8463) ; [pepsi] DKIM_ALGORITHMS permet de n’en choisir qu’une. Les clés privées sont détenues par le démon de signature pepsi-dkim, sous son propre compte, qui signe pour l’étape et peut faire tourner les clés selon un calendrier (Rotation des clés DKIM) ; aucune étape ne peut lire une clé. Malgré tout, les signatures de Pepsi ne sont pas plus solides que le compte sous lequel tourne le pipeline : n’importe quelle étape peut demander une signature au démon, ou réécrire un message après que l’entrée a vérifié son From: (Un composant compromis). Gmail, Microsoft 365 et Yahoo ne vérifient pas Ed25519, et Google indique une telle signature comme fail dans ses rapports agrégés DMARC ; DMARC réussit malgré tout grâce à la signature RSA. La signature couvre toujours le corps entier : le tag de longueur de corps l= de la RFC 6376 n’est jamais émis, car les vérificateurs stricts rejettent d’emblée une telle signature au lieu de tolérer la couverture plus courte. La signature est fail-closed : un message d’un domaine pour lequel le démon ne signe pas est refusé au lieu d’être transmis non signé, et tant que le démon est injoignable le message attend et est réessayé. Comme la sélection d’en-têtes se fait de bas en haut, la signature ne perturbe pas les signatures existantes.

11.13. Notifications d’état de remise

Pepsi implémente DSN de bout en bout (RFC 3461 / RFC 3463 / RFC 3464) :

  • L’ingress annonce DSN et valide/stocke RET/ENVID (sur MAIL FROM) et NOTIFY/ORCPT (sur RCPT TO) sous state.dsn.

  • Les étapes de relais propagent ces paramètres à un saut suivant qui annonce aussi DSN, et les omettent sinon (RFC 3461 §6 : Pepsi ne devient pas le relais responsable du DSN).

  • pepsi-stage-bounce émet le rapport sous forme de multipart/report RFC 3464 avec des codes d’état étendus RFC 3463 :

    • un rapport d”échec lorsque NOTIFY demande FAILURE (la valeur par défaut en son absence) — NOTIFY=NEVER abandonne silencieusement ;

    • un rapport de succès (Action: delivered) uniquement lorsque le ORIGINATE_SUCCESS_DSN global est activé et que NOTIFY=SUCCESS a été demandé ;

    • un rapport de délai (Action: delayed) lorsque le DELAY_DSN_AFTER d’une étape de relais s’écoule sur un message encore en file d’attente qui a demandé NOTIFY=DELAY (envoyé au plus une fois).

Un message à expéditeur nul (un rebond) ne fait jamais lui-même l’objet d’un rebond (RFC 5321 §6.1). Lorsque le chemin de retour en refuse un, les deux étapes de relais le conservent jusqu’à ce qu’une copie parvienne à POSTMASTER, si cette option est définie. Pour un message arrivé chiffré, un rapport ne renvoie jamais le corps ni l’objet, quoi qu’ait demandé RET, si bien qu’un rebond ne peut pas restituer du contenu déchiffré à celui qui a envoyé le texte chiffré (Les rebonds après déchiffrement à la passerelle révèlent le contenu déchiffré).

11.14. Adresses recyclées

Un identifiant de connexion qu’un opérateur supprime puis attribue plus tard à quelqu’un d’autre recevrait du courrier destiné à son précédent propriétaire, et hériterait de son état. Pepsi met en œuvre la RFC 7293 (Require-Recipient-Valid-Since) contre cela, et définit ce que perd un identifiant recyclé (le mécanisme est décrit dans Un identifiant de connexion qui change de propriétaire) :

  • L’enregistrement. pepsi.login_assignment contient, par identifiant passwd, l’uid qu’il a et le moment où cette attribution a été vue pour la première fois. La remise locale enregistre chaque identifiant auquel elle livre (en LMTP, chaque destinataire accepté que passwd connaît ; les utilisateurs virtuels propres au MDA ne sont pas couverts) ; pepsi-setup run et le pepsi-queue gc horaire revérifient chaque identifiant enregistré par rapport à passwd. Un identifiant vu sous un autre uid, ou revu après qu’une vérification l’a trouvé disparu, a un nouveau propriétaire. Un identifiant vu pour la première fois n’est pas une réattribution, car ce qui s’est passé avant que Pepsi ne surveille est inconnu.

  • Ce dont un nouveau propriétaire n’hérite pas. Lorsque le changement est remarqué, la base de données abandonne les surcharges pepsi.settings du précédent propriétaire, ses propres listes blanches <login>/... (et les défis de confirmation à l’envoi en attente), sa ligne de quota de boîte aux lettres, ses journaux de réponses d’absence et de demande de paiement, ses demandes de confirmation de liste de diffusion en attente, ainsi que ses liens d’enrôlement et sessions de console ; elle dévalide les adresses de liste de diffusion de l’identifiant, les détache du compte de liste du précédent propriétaire et arrête la remise à leurs abonnements simples, et journalise un événement account.reassigned (nommant tout rôle de propriétaire ou de modérateur de liste que les adresses détiennent encore). Le matériel de clé est conservé : les identités du magasin de clés, les clés de pairs en cache et un second facteur TOTP sont signalés par pepsi-setup run et check avec la commande qui dispose de chacun, car une clé privée supprimée ne peut pas être restaurée et peut être le seul moyen d’ouvrir le courrier archivé du précédent propriétaire.

  • L’extension SMTP. L’entrée annonce RRVS et accepte RRVS=<date-time>[;C|R] sur RCPT TO. Un destinataire dont l’identifiant a un changement de propriétaire enregistré après cette date est refusé avec 550 5.7.17. Un identifiant qui n’a eu qu’un propriétaire à la connaissance de Pepsi passe pour n’importe quelle date, si bien que la réponse ne révèle rien des adresses qui n’ont jamais été recyclées ; les adresses de rôle (postmaster, abuse, …) sont exemptées, et les refus comptent dans MAX_INVALID_RECIPIENTS.

  • Le champ d’en-tête. Lors de la remise locale (pepsi-stage-relay-to-maildir) et avant l’exécution d’un ~/.forward (pepsi-stage-dot-forward), le paramètre est vérifié à nouveau avec une nouvelle recherche passwd (à défaut de paramètre, c’est un champ Require-Recipient-Valid-Since: nommant ce destinataire qui est vérifié), et un destinataire qui échoue fait l’objet d’un rebond avec 5.7.17 au lieu d’être livré. Le champ est retiré de la copie livrée.

  • Relais. Les étapes de relais transmettent le paramètre à un saut suivant qui annonce RRVS. Vers un saut qui ne l’annonce pas, l’action par défaut en l’absence de prise en charge, R, fait échouer le destinataire avec 5.7.19 ; C continue, la demande étant écrite comme champ d’en-tête pour ce seul destinataire. Les cibles d’alias et les adresses réexpédiées n’héritent jamais d’une demande.

11.15. Exiger TLS

La politique de transport est normalement publiée par le destinataire (MTA-STS, DANE) et respectée par l’expéditeur ; la RFC 8689 permet à l”émetteur d’un message d’exiger un TLS validé sur chaque saut, ou de lever pour ce message la politique du destinataire :

  • L’extension SMTP. L’entrée n’annonce REQUIRETLS qu’une fois la session protégée par TLS, et n’accepte le paramètre de MAIL FROM que là (530 5.7.10 en clair) : l’annoncer promet de transmettre l’exigence plus loin. Un message qui arrive avec lui est étiqueté state.tls_required = "required", et chaque division ou clone hérite de l’étiquette. Un message qui arrive sans lui mais avec un champ d’en-tête TLS-Required: No est étiqueté "no".

  • Relayer un message exigeant TLS. Les étapes de relais ne l’envoient qu’à un saut suivant dont DNSSEC ou une politique MTA-STS valide le nom (remise directe) ou que la configuration nomme (un smarthost), en STARTTLS obligatoire avec un certificat authentifié par DANE ou PKIX, et seulement si le saut annonce REQUIRETLS après la mise à niveau ; le paramètre est transmis. Chaque hôte MX est essayé ; lorsqu’aucun ne convient, le message fait l’objet d’un rebond avec 5.7.30 (pas de REQUIRETLS là-bas) ou 5.7.10 (pas de TLS validé), selon la RFC 8689 §4.2.1. Le TLS_VERIFY = no d’une entrée smarthost est ignoré, et MODE = plain refuse le message.

  • Relayer un message ``TLS-Required: No``. La remise directe utilise un STARTTLS opportuniste vers chaque hôte MX, une politique MTA-STS enforce et DANE à titre indicatif ; une poignée de main qui échoue n’est toujours jamais réessayée en clair. Les réglages du smarthost sont la propre politique du site et restent en vigueur.

  • Rebonds. Un DSN pour un message exigeant TLS ne renvoie que les en-têtes (RET=FULL n’est pas pris en compte), porte l’étiquette, est renvoyé sur un TLS validé avec le paramètre là où le chemin de retour l’annonce, et n’est pas abandonné pour un saut dépourvu de l’extension (§5).

Le mécanisme et ses limites sont décrits dans Exiger TLS pour un message (RFC 8689) ; ce qu’il change pour l’adversaire réseau est décrit dans Un attaquant réseau actif.

11.16. Contenu internationalisé et 8 bits

L’ingress annonce 8BITMIME (RFC 6152) et SMTPUTF8 (RFC 6531) et note la déclaration BODY=. Comme les capacités d’un saut suivant sont inconnues jusqu’après la connexion, le client SMTP sortant décide par saut :

  • Si le saut prend en charge l’extension, Pepsi ré-annonce BODY=8BITMIME / SMTPUTF8.

  • Sinon il rétrograde : les parties MIME terminales 8 bits sont ré-encodées vers un codage de transfert 7 bits (RFC 2045 : quoted-printable pour text/*, base64 sinon), d’après les octets constatés plutôt que d’après l’encodage déclaré ; les champs d’en-tête UTF-8 sont réécrits en mots encodés RFC 2047, aux trois endroits où le §5 de la RFC 2047 en autorise un (un champ non structuré, une phrase de nom d’affichage, l’intérieur d’un commentaire) ; un paramètre Content-Type / Content-Disposition non ASCII, comme le nom de fichier d’une pièce jointe dans n’importe quelle partie MIME, prend la forme RFC 2231 (filename*=UTF-8''caf%C3%A9.txt), et un boundary= non ASCII, qui n’a pas de forme encodée, est remplacé par un nouveau délimiteur ASCII, lignes de délimitation comprises.

  • Les octets rétrogradés sont ensuite retestés : la conversion se fait au mieux sur un message que personne n’a validé, et le §3 de la RFC 6152 interdit « en toutes circonstances » d’offrir du contenu 8 bits à un saut qui n’a pas annoncé 8BITMIME ; un corps encore 8 bits après coup est donc un échec permanent (rebond).

  • Une adresse non ASCII (d’enveloppe, ou à l’intérieur d’une adresse d’en-tête) qui ne peut être représentée vers un saut non-SMTPUTF8 est un échec permanent (rebond).

Le réencodage du corps casse nécessairement une signature DKIM/ARC couvrant le corps déjà présente sur le message ; c’est inévitable (les capacités sont connues tardivement) et rare. La propre signature DKIM de Pepsi est faite sur un corps que pepsi-stage-dkim-sign a déjà converti en 7 bits (RFC 6376 section 5.3), si bien que le relais la laisse intacte.

11.17. Relais sortant

Deux étapes de relais interchangeables envoient le courrier vers l’extérieur :

  • pepsi-stage-relay-to-internet — remise directe vers le MX (RFC 5321 §5) : sa propre résolution MX avec ordonnancement par préférence et sélection d’adresse Happy-Eyeballs (mise en cache par adresse dans pepsi.dns_address), MX implicite via les enregistrements d’adresse (§5.1) et gestion du Null MX (RFC 7505). Le TLS est authentifié par MTA-STS (RFC 8461) avec vérification de l’identité du certificat (RFC 6125) ; les politiques enforce exigent STARTTLS vers un MX listé.

  • pepsi-stage-relay-to-smarthost — relais via un smarthost configuré, choisi par domaine de destinataire (ou un attrape-tout), avec transport par MTA (plain/tls/starttls), vérification de certificat et la suite SMTP AUTH (RFC 4954) complète (PLAIN/LOGIN, CRAM-MD5, SCRAM-SHA-1/-SHA-256 avec liaison de canal -PLUS facultative, OAUTHBEARER/XOAUTH2, SASL EXTERNAL avec un certificat client TLS, NTLM, GSSAPI/Kerberos et le DIGEST-MD5 déprécié) ou négociation auto. Voir Authentification du client et l”index des RFC.

Les deux étapes appliquent la protection contre les boucles, en comptant les en-têtes Received: du message par rapport à leur propre option MAX_HOP_COUNT. C’est un réglage d’étape de relais, dans la section [stage-<name>] de chaque étape, et non un réglage de l’ingress, de sorte qu’un message est arrêté au moment où il est sur le point d’être renvoyé plus loin plutôt qu’à son arrivée.

Les deux étapes authentifient le TLS du saut suivant avec DANE (RFC 7672, DANE = off|warn|strict, strict par défaut comme l’exige la RFC 7672 §2.2). Elles résolvent les enregistrements TLSA du saut et les comparent à la chaîne présentée. DANE a priorité sur MTA-STS, si bien qu’un enregistrement TLSA utilisable rend TLS obligatoire et qu’une non-correspondance diffère la remise (L’adversaire réseau). Lorsque [pepsi-tlsrpt] SEND_REPORTS est activé (il est désactivé par défaut), les deux étapes notent aussi chaque session TLS sortante pour le TLS Reporting (RFC 8460), et pepsi-tlsrpt expédie les rapports agrégés quotidiens.

Les deux étapes partagent une sémantique de réessai : un échec transitoire met le message en pause avec un backoff exponentiel (RETRY_INITIAL/ RETRY_MAX_INTERVAL/RETRY_FACTOR) jusqu’à MAX_LIFETIME, après quoi il rebondit ou est mis en échec ; un échec permanent achemine vers BOUNCE_STAGE (ou marque la ligne failed).

11.18. Remise locale

Pour les destinataires d’un domaine local, trois étapes classent le courrier sur l’hôte au lieu de le relayer (chacune transfère les destinataires qu’elle ne peut traiter à son NEXT_STAGE, de sorte qu’elles se composent) :

  • pepsi-stage-relay-to-maildir — écrit le message directement dans le Maildir/new/ de chaque utilisateur local. La localité est décidée par LOCAL_DOMAINS et TARGETS (plages d”uid passwd) ; l’écriture privilégiée est faite par le pepsi-helper-maildir-writer setuid-root, atteint via le bit set-group-id pepsi-maildir propre à l’étape.

  • pepsi-stage-relay-to-lmtp — remet le message à un Mail Delivery Agent local (typiquement Dovecot) via LMTP (RFC 2033), qui exécute le filtre Sieve (RFC 5228) de chaque destinataire lors du classement du courrier. Elle remet un seul destinataire par transaction et achemine plus loin chacun de ceux que le MDA rejette, selon son état RFC 3463. N’a besoin d’aucun helper privilégié (le MDA abandonne ses privilèges).

  • pepsi-stage-dot-forward — traite le fichier ~/.forward de chaque utilisateur local (le mécanisme sendmail/Postfix classique) via le pepsi-helper-dot-forward setuid-root, qui abandonne ses privilèges au profit de l’utilisateur avant de le lire : les adresses redirigées redémarrent le pipeline, les directives |pipe//file s’exécutent en tant que l’utilisateur, et un destinataire sans ~/.forward passe sans changement.

pepsi-stage-aliases complète celles-ci en étendant les destinataires d’enveloppe à travers une table de style virtual(5) de Postfix (adresse complète ou attrape-tout @domain, étendue transitivement) avant la remise locale.

pepsi-stage-vacation répond au courrier qui arrive pendant l’absence d’un destinataire, et marque l’objet de la copie transmise afin qu’à son retour il voie à quel courrier il a été répondu pour lui. C’est la seule action de filtrage utilisateur que Pepsi met en œuvre lui-même plutôt que de la laisser au Sieve d’un MDA. La réponse est un nouveau message qui doit être signé et relayé, et décider de ne pas en envoyer une demande une connaissance que seul le pipeline possède : la RFC 3834 dit de ne jamais répondre à un rebond, au courrier de liste de diffusion, à tout ce qui est déjà marqué automatique, ni à une adresse de service, et Pepsi y ajoute son propre « ne jamais répondre au spam », « ne jamais répondre à un expéditeur dont le SPF ou le DMARC a échoué de façon certaine » (la réponse irait à une adresse contrefaite) et une limitation de débit par correspondant. Les dates de congé sont de la configuration par adresse ordinaire, de sorte que la même option est un jour férié national à portée globale et le congé d’une personne dans sa propre ligne pepsi.settings.

pepsi-stage-route les complète différemment : au lieu de remettre, elle choisit un saut suivant par destinataire d’après le domaine de ce destinataire, scindant le message lorsque ses destinataires divergent. C’est ce qui permet à Pepsi de se placer devant un système de courrier existant : les domaines situés derrière la passerelle vont vers ce système, et le reste vers l’internet. C’est aussi là que pepsi-setup prouve qu’aucun domaine que sert cet hôte ne peut être réacheminé vers son propre ingress. Voir Microsoft Exchange comme passerelle.

11.19. Listes de diffusion et archives

Le sous-système de listes de diffusion de Pepsi est une réimplémentation de GNU Mailman 3 : son modèle de données, son architecture rule/chain et handler/pipeline, son API REST, son vocabulaire de commandes par e-mail et les noms de ses modèles de notification relèvent de la conception du projet GNU Mailman, dont la Free Software Foundation détient les droits. Les fichiers repris de GNU Mailman, Postorius ou HyperKitty restent sous licence GNU General Public License (vendor/PEPSI-VENDORING.md les recense). Le test d’acceptation est qu’un mailmanclient, un Postorius ou un HyperKitty non modifié le pilote. Voir Listes de diffusion, Archives et L’API REST de GNU Mailman 3.

  • Cinq étapes de pipeline plutôt qu’un démon dédié : routage, envoi, remise par membre, commandes par e-mail et traitement des rejets. Un message de liste est ainsi un enregistrement de file ordinaire que ARC, DKIM, SRS, TLS et les étapes de relais traitent déjà. Comment le sous-système est agencé en donne la carte.

  • Neuf adresses par liste et aucun fichier d’alias. Mailman écrit des tables Postfix ou Exim pour les neuf adresses de chaque liste et recharge le MTA ; Pepsi route sur le destinataire à l’intérieur de son propre pipeline, il n’y a donc rien à régénérer et rien qui puisse se désynchroniser.

  • Une modération au vocabulaire d’amont : dix-huit règles, quatre chaînes terminales (accept, hold, reject, discard) et un pipeline de dix-sept gestionnaires, sous les noms que l’API REST rapporte. Pepsi ajoute une règle qui lui est propre, dmarc-failure, qui retient un message ayant échoué à DMARC sur une liste où hold_dmarc_failures est activé (la valeur par défaut pour les listes que crée Pepsi).

  • En-têtes ``List-*`` (RFC 2369) et ``Archived-At`` (RFC 5064) sur chaque message de liste.

  • Désabonnement en un clic (RFC 8058) – List-Unsubscribe-Post et une URI https: scellée par une clé, honorée par un unique POST. Amont ne l’a pas. Différences déclarées avec GNU Mailman 3 recense ce point et les autres endroits où Pepsi va plus loin qu’amont.

  • Les résumés dans les deux formats : le résumé simple de la RFC 1153 et le multipart/digest MIME, par abonné, avec numérotation de volume et de livraison, un seuil de taille et une minuterie périodique.

  • Le traitement des rejets avec la logique de score d’amont, l’attribution VERP sur chaque copie (les dix-sept détecteurs heuristiques sont donc le recours et non le mécanisme), des messages de sonde facultatifs, des avertissements puis, à terme, le désabonnement.

  • Des archives avec recherche plein texte, recherche facultative de sous-chaînes par trigrammes, import et export mbox, et un purge qui laisse une pierre tombale. Elles réimplémentent HyperKitty et conservent son hachage de Message-ID et son schéma d’URL, de sorte que les liens d’archives existants survivent à une migration.

  • La migration depuis Mailman 2.1 et 3 : la config.pck de 2.1 est lue par une machine pickle restreinte, incapable d’instancier une classe (un pickle non fiable est donc une donnée et non du code), et un serveur Mailman 3 est lu via sa propre API REST.

  • Aucun JavaScript sur aucune page de liste ou d’archives (Absence de durcissement HTTPS et des en-têtes de sécurité HTTP sur le webmail), hormis les deux pages de membre qui mènent une cérémonie WebAuthn et chargent un unique script statique autorisé par son hachage ; et aucun 403 sur une surface publique : un refus est le même 404 qu’obtient une liste inexistante, car un 403 révèle qu’elle existe.

11.20. Courrier non sollicité

Pepsi filtre après avoir accepté un message ; tout ce qui suit décide donc du sort d’un courrier déjà dans la file. Trois mécanismes coopèrent au travers d’un unique verdict, state.spam, et d’une unique table, pepsi.whitelist :

  • La liste blanche des correspondants. pepsi-stage-auto-whitelist consigne les destinataires du courrier qu’envoient vos utilisateurs ; pepsi-stage-check-whitelist reconnaît leurs réponses et définit state.spam = false. Elle peut ne le faire que lorsque DKIM, un succès DMARC aligné (SPF aligné compris), une signature vérifiée ou un scelleur ARC nommé s’en porte garant. L’opérateur et les utilisateurs peuvent la gérer à la main avec pepsi-whitelist.

  • Péage à l’envoi (pepsi-stage-anti-spam) : le courrier de toute autre personne est retenu jusqu’à ce que son expéditeur paie un petit montant GNU Taler. L’autre versant en est pepsi-stage-auto-pay, qui paie, dans leurs limites, les demandes qui reviennent en réponse au courrier sortant de vos propres utilisateurs.

  • Confirmation à l’envoi (pepsi-stage-secretary) : le courrier de toute autre personne est retenu jusqu’à ce que son expéditeur réponde une fois à un défi. La réponse le place en liste blanche, de sorte qu’un correspondant n’est sollicité qu’une seule fois, pour toujours.

Les milters (SpamAssassin, rspamd, ClamAV, …) peuvent eux aussi fixer ou éclairer le verdict : pepsi-ingress les consulte pendant la session SMTP, et pepsi-stage-milter en exécute un comme étape du pipeline. Le filtre de langue aussi : pepsi-stage-detect-language enregistre la langue, et pepsi-stage-block-language lui attribue un score. Une étape pepsi-stage-if bifurque selon n’importe laquelle de ces valeurs enregistrées, et pepsi-stage-discard est le puits dans lequel une branche peut se terminer.

11.20.1. Listes blanches partagées et par utilisateur

Chacune de ces étapes nomme sa liste avec WHITELIST_NAME. Un nom est soit global (correspondents), soit propre à un compte (alice/sent, l’espace de noms <login>/... ; les modèles {login}/{localpart} se développent en un tel nom pour chaque destinataire, là où une étape les prend en charge).

Une entreprise veut généralement une seule liste partagée par tous les employés : un client à qui l’on a dit d’écrire à un collègue, plutôt qu’à l’employé qui lui a écrit en premier, ne doit pas être arrêté par le filtre anti-spam. L’opérateur la définit une fois

[stage-auto-whitelist]
PROGRAM = pepsi-stage-auto-whitelist
NEXT_STAGE = dkim-sign
WHITELIST_NAME = correspondents

[stage-check-whitelist]
PROGRAM = pepsi-stage-check-whitelist
NEXT_STAGE = anti-spam
WHITELIST_NAME = correspondents

L’opérateur peut nommer n’importe quelle liste, partagée ou par utilisateur, dans chaque couche qu’il contrôle : le fichier INI, pepsi.config_override à n’importe quelle portée (une autre liste partagée pour le domain: d’un service, par exemple) et les enregistrements pepsi.settings écrits avec pepsi-settings. Un titulaire de compte autorisé à modifier pepsi-stage-auto-whitelist ou pepsi-stage-secretary par e-mail (pepsi-stage-edit-settings) ne peut que déplacer le WHITELIST_NAME de ces étapes dans son propre espace de noms, ou le ramener à la liste de l’opérateur : les deux étapes écrivent dans la liste, de sorte qu’un nom partagé ou étranger permettrait à un utilisateur de la remplir d’adresses de son choix. pepsi-stage-check-whitelist ne fait que lire et n’est pas soumise à une telle restriction.

Prudence

Le péage exempte l”expéditeur d’enveloppe nul et le courrier que ce déploiement a injecté lui-même. La notification de lien et le courrier de PIN du portail de lien sécurisé portent l’expéditeur d’origine comme expéditeur d’enveloppe ; ils sont marqués d’un en-tête Pepsi-Origin lié à leurs destinataires, si bien que lorsqu’ils reviennent vers une boîte aux lettres soumise au péage sur le même déploiement, ils passent (avec la preuve d’origine activée, ce qui est le cas par défaut). Une réponse rédigée dans le portail est reconnue à l’état avec lequel elle est injectée. Le péage retient malgré tout du courrier pour lequel personne ne paiera : les messages des listes de diffusion portent l’adresse From: de leurs auteurs, qu’aucune liste de correspondants ne couvre, et leurs champs List-* suppriment la demande de paiement : chaque message est donc retenu puis rejeté sans que personne ait été invité à payer. (Les avis d’absence et les demandes de paiement elles-mêmes utilisent l’expéditeur nul et ne sont pas retenus.)

Mettez chaque liste en liste blanche par son identifiant et son scelleur ARC, dans un groupe que nomme [stage-check-whitelist] WHITELIST_NAME

pepsi-whitelist add-list --sealer lists.example.org \
    correspondents users.lists.example.org

pepsi-stage-anti-spam en donne le détail.

11.20.2. Listes de diffusion auxquelles vos utilisateurs sont abonnés

Les messages d’une liste portent l’adresse From: de leurs auteurs ; une liste est donc mise en liste blanche dans son ensemble par son List-Id: (une ligne list-id). Les utilisateurs n’ont pas à saisir ces identifiants :

  • Hors ligne, pepsi-whitelist import propose chaque liste dont l’utilisateur a répondu à au moins un message dans la boîte aux lettres analysée, et ajoute chaque liste que l’utilisateur confirme (une question par liste, toutes avec --yes, aucune en exécution sans surveillance). Voir pepsi-whitelist.

  • En direct, avec [stage-check-whitelist] RECORD_LIST_CONFIRMATIONS = yes et [stage-auto-whitelist] LIST_WHITELIST_NAME = {login}/lists, un utilisateur qui répond à la demande de confirmation d’abonnement d’une liste obtient la mise en liste blanche de cette liste dans son propre <login>/lists. La demande entrante est enregistrée dans pepsi.list_confirmation et la réponse sortante doit la nommer dans In-Reply-To: et aller à son adresse de contrôle ; rien de plus faible ne compte, si bien qu’un attaquant ne peut pas implanter une règle en obtenant une réponse à un message ordinaire. Quitter une liste n’envoie aucun signal ; une ligne apprise expire donc après LIST_MAX_IDLE_DAYS (180) sans message correspondant. Ajoutez {login}/lists au WHITELIST_NAME de l’étape de vérification pour qu’elle soit consultée.

Dans les deux cas, la ligne garde dkim_required (et, lorsqu’elle est apprise, dmarc_required d’après DMARC_REQUIRED) : un List-Id: est un texte que n’importe quel expéditeur peut copier, si bien qu’un message doit encore être authentifié pour correspondre. Ajouter --sealer à la main (pepsi-whitelist) restreint encore la ligne, au courrier que le propre scelleur ARC de la liste a traité.

11.20.3. Péage à l’envoi et confirmation à l’envoi comparés

Tous deux retiennent le courrier des expéditeurs inconnus et tous deux envoient à l’expéditeur une réponse automatique à expéditeur nul, dans sa langue. Ils diffèrent par ce que l’expéditeur doit prouver :

Péage à l’envoi

Confirmation à l’envoi

L’expéditeur prouve

qu’il dépensera de l’argent pour ce message

qu’il peut lire le courrier à l’adresse depuis laquelle il a écrit

Arrête

le courrier de masse à tout volume, y compris depuis des boîtes aux lettres fonctionnelles

le courrier de masse provenant d’adresses qui ne peuvent pas recevoir (la plus grande partie)

N’arrête pas

un expéditeur disposé à payer

un spammeur disposant d’une boîte aux lettres fonctionnelle, qui peut automatiser la réponse

Dissuasion

économique : chaque message a un coût

juridique uniquement : PENALTY indique ce que l’expéditeur accepte de payer si le courrier n’était pas sollicité, ce que rien ne fait respecter

Nécessite

un backend marchand GNU Taler, et un wallet du côté de l’expéditeur

rien d’autre qu’une réponse

Disons-le clairement : la confirmation à l’envoi est le filtre le plus faible. Elle vaut tout de même d’être utilisée, car elle coûte une réponse à un correspondant légitime et rien à l’exploitation d’un serveur de messagerie. Et les deux se combinent. Lorsque les deux sont activés, le secrétaire s’exécute en premier et son UNCHALLENGEABLE_STAGE pointe vers le péage, de sorte que le courrier auquel on ne peut pas demander de répondre (un envoi de liste, un expéditeur non authentifié ou falsifié, un expéditeur au-delà du plafond quotidien de défis) est invité à payer à la place, tandis qu’un expéditeur confirmé atteint le péage avec state.spam = false et le franchit sans y être touché.

La confirmation à l’envoi prend garde au backscatter, puisque son défi va à l’expéditeur d’enveloppe et que l’expéditeur d’enveloppe du spam est généralement falsifié : elle ne défie qu’un expéditeur qui a passé SPF ou DMARC (REQUIRE_AUTHENTICATED) et dont le From: est cette même adresse, au plus MAX_CHALLENGES_PER_SENDER fois par jour, tous utilisateurs confondus ; elle ne répond jamais à ce que la RFC 3834 interdit de répondre ; et son défi ne cite rien du message retenu hormis un court aperçu de son objet (SUBJECT_HINT_LENGTH, huit caractères par défaut), et pas même cela pour un message arrivé chiffré, si bien que le défi ne peut pas révéler l’issue d’un déchiffrement (Oracles de remplissage et de format CBC contre S/MIME non authentifié).

11.20.4. Filtres anti-spam et secrétaire

Par défaut, les milters de notation du spam (SpamAssassin via spamass-milter, rspamd, MIMEDefang, …) sont consultés par pepsi-ingress pendant la session SMTP ; ils s’exécutent donc avant la vérification de liste blanche, et l’assistant de pepsi-setup génère cet ordre :

pepsi-ingress (MILTERS = spamassassin) → … → check-whitelist → secretary → local
                                                     UNCHALLENGEABLE_STAGE = local

Un message que le filtre rejette est refusé dans la session et n’atteint jamais le secrétaire, de sorte que le spam évident ne provoque aucun défi vers son expéditeur falsifié, et qu’aucun backscatter ne se produit. Ce qui atteint le secrétaire a passé le filtre, c’est pourquoi l’assistant fixe UNCHALLENGEABLE_STAGE au propre NEXT_STAGE du secrétaire : exécuter à nouveau le filtre reviendrait à analyser deux fois.

L’alternative consiste à exécuter le filtre après le secrétaire, comme étape pepsi-stage-milter, de sorte qu’il n’analyse que le courrier qui n’a pas pu être soumis à un défi :

… → check-whitelist → secretary → local
                        └─ UNCHALLENGEABLE_STAGE → milter-spamassassin → local

La modification de configuration, pour un filtre en [pepsi-ingress-milter-spamassassin] :

  1. Sortez le filtre de la session : retirez spamassassin de [pepsi-ingress] MILTERS, et la section avec lui.

  2. Écrivez [stage-milter-spamassassin] avec PROGRAM = pepsi-stage-milter, le même SOCKET et les mêmes ALLOW_ACTIONS, et NEXT_STAGE fixé au NEXT_STAGE du secrétaire (ici local).

  3. Dans [stage-secretary], définissez UNCHALLENGEABLE_STAGE = milter-spamassassin.

Exécutez ensuite pepsi-setup check (ou run) pour valider le graphe.

Le compromis joue dans les deux sens :

  • Pour : le temps CPU du filtre n’est dépensé que pour le courrier qui en a besoin. Le courrier en liste blanche et celui des expéditeurs confirmés, qui forment l’essentiel d’une boîte aux lettres personnelle, ne sont jamais analysés.

  • Contre : les défis partent sans analyse. Le spam que le filtre aurait rejeté provoque d’abord un défi, soit davantage de backscatter vers des expéditeurs falsifiés (borné par REQUIRE_AUTHENTICATED et le plafond quotidien, mais pas nul). Et le spam dont l’expéditeur confirme effectivement est remis sans que le filtre ne l’ait jamais vu ; c’est le seul type de spam que la confirmation à l’envoi ne peut pas arrêter.

Quelle que soit la disposition choisie, les milters antivirus et de politique restent dans la session (avant la vérification de liste blanche) : un correspondant confirmé ou en liste blanche peut tout de même envoyer un logiciel malveillant, depuis un compte compromis ou à son insu, et le verdict d’un filtre de politique s’applique à tout le monde.

11.21. Fonctionnalités opérationnelles

  • Pipeline à table unique avec récupération après plantage : les lignes running orphelines sont réinitialisées au démarrage du dispatcher ; les enfants en vol sont réinitialisés à l’arrêt.

  • Pools de workers élastiques et pipelinés, et chien de garde : chaque étape exécute des processus workers persistants démarrés à la demande jusqu’à son PARALLELISM et récupérés après WORKER_IDLE_TIMEOUT, recyclés après MAX_MESSAGES ; chaque worker reçoit jusqu’à QUEUE_LIMIT messages à la fois (capacité en vol QUEUE_LIMIT × PARALLELISM, sans coût de connexion supplémentaire), et un worker dépassant MAX_RUNTIME sur le message qu’il traite est tué et remplacé.

  • Outillage de file d’attente : pepsi-queue liste, supprime, remet à une autre étape et débloque en masse les messages.

  • Surveillance de santé : pepsi-status imprime un résumé en lecture seule de la file d’attente, des messages bloqués, des compteurs cumulatifs de remise/échec et des issues TLS sortantes récentes (aussi en --json), adapté à une exécution via SSH.

  • Provisionnement et vérification DNS : pepsi-setup installe le schéma, fait créer les clés DKIM et génère les autres, et imprime/valide le DNS (DKIM, SPF, MTA-STS).

  • Serveur HTTP : pepsi-httpd sert, sur un ou plusieurs écouteurs TLS (sélectionnés par SNI) ou en clair, le fichier de politique MTA-STS (/.well-known/mta-sts.txt), une page Prometheus /metrics (sur un écouteur ADMIN = yes uniquement, car elle décrit le pipeline), les points de terminaison Web Key Directory qui publient les identités propres de ce déploiement (/.well-known/openpgpkey/…, formes directe et avancée), le portail Le portail de repli par lien sécurisé, et le document d”autoconfiguration du courrier ci-dessous.

  • Autoconfiguration des clients de messagerie (draft-ietf-mailmaint-autoconfig) : un client à qui l’on ne donne que fred@example.org récupère https://autoconfig.example.org/mail/config-v1.1.xml et se configure lui-même — hôte de soumission, port, sécurité de transport et authentification, et de même pour le serveur de boîtes aux lettres. La moitié soumission est dérivée de l’écouteur de soumission en fonctionnement, de sorte qu’elle ne peut pas dériver du serveur qu’elle décrit ; la moitié boîte aux lettres nomme le MDA auquel le déploiement s’associe. Un serveur sans TLS n’est publié qu’une fois que l’opérateur en a pris acte (ALLOW_PLAIN_AUTOCONFIG) ; sinon la configuration est refusée, en nommant le serveur. Le document est servi publiquement et sans authentification, comme l’exige le brouillon, parce qu’un client doit le lire avant de pouvoir savoir comment s’authentifier.

  • API et console d’administration : sur un écouteur explicitement marqué ADMIN = yes, le même serveur expose l”L’API d’administration sous /api/v1 (file d’attente, santé, configuration, magasin de clés, journaux d’audit et de courrier) et la La console d’administration de navigateur sous /ui, qui est cliente exactement de cette API. Il ne le fait jamais sur un écouteur qui les transporterait en clair hors de l’hôte. Partout ailleurs, ces chemins répondent le même 404 qu’un chemin inconnu. L’authentification se fait par identifiants de pair sur socket UNIX, par cookie de session ou par jeton porteur, et chaque principal porte des portées ; tout cela est audité. Les utilisateurs finaux peuvent se connecter par courrier : un lien à usage unique envoyé à une adresse que le serveur sert ouvre une session confinée à cette adresse (Se connecter par courrier).

  • Métriques : pepsi-dispatch note le débit par étape, les kills/timeouts, les plantages et le temps de traitement ainsi que les totaux globaux d’étapes/messages (vidés dans la base de données en une transaction environ une fois par minute), exportés par pepsi-httpd aux côtés des jauges actives/en pause en direct lues depuis la file d’attente.

  • Journalisation structurée via tracing à des niveaux configurables.

Pour les normes que Pepsi n’implémente pas (BINARYMIME entre autres), voir RFC applicables pas encore implémentées.

11.22. Stabilité des fonctionnalités

Chaque fonctionnalité décrite dans ce chapitre est suivie dans une unique table Stabilité des fonctionnalités. Pour chaque fonctionnalité, elle note la RFC qui la régit, si elle dispose d’un test automatisé (et de quel type : U unitaire, I intégration, I/U les deux), si elle a été vérifiée à la main, et à quel point elle est largement déployée et exercée selon une télémétrie d’usage anonyme et sur consentement explicite (pepsi-telemetry).

Cette table est générée : contrib/update-feature-stability.sh fusionne le registre maintenu à la main contrib/feature-registry.tsv (colonnes nom, RFC, test et test-manuel) avec un GET /telemetry/report de pepsi-telemetry (les comptes de déploiement et d’usage). Voir Étendre le pipeline pour savoir comment la maintenir à jour quand vous ajoutez une fonctionnalité, écrivez un test ou rafraîchissez les comptes de télémétrie.