12. Extensions du protocole SMTP¶
Pepsi annonce ces extensions de service ESMTP normalisées dans sa réponse EHLO (pepsi-ingress ; les normes applicables figurent dans Index des RFC) : SIZE (RFC 1870), 8BITMIME (RFC 6152), SMTPUTF8 (RFC 6531), PIPELINING (RFC 2920), CHUNKING (RFC 3030, sans BINARYMIME), DSN (RFC 3461), ENHANCEDSTATUSCODES (RFC 2034) et RRVS (RFC 7293) toujours ; STARTTLS (RFC 3207) tant que la session d’un écouteur starttls est encore en clair ; et REQUIRETLS (RFC 8689) et AUTH (RFC 4954) seulement une fois la session protégée par TLS. Le client sortant respecte le même ensemble au saut suivant : les paramètres DSN, 8BITMIME, SMTPUTF8, RRVS et REQUIRETLS ne sont envoyés qu’à un saut qui les annonce, et le contenu ou les demandes sont rétrogradés ou refusés comme le prescrit chaque norme lorsqu’il ne le fait pas (Fonctionnalités prises en charge).
Au-delà de celles-ci, Pepsi définit deux champs d’en-tête de message qui lui sont propres :
l’en-tête de preuve d’origine
Pepsi-Origin:, apposé sur le courrier sortant ; etl’en-tête de paiement
Taler:, qui annonce à un wallet une demande de paiement de péage à l’envoi.
Aucun des deux n’est enregistré auprès de l’IANA au titre de la RFC 3864. Ce sont tous deux des extensions privées que seul un déploiement Pepsi (et, pour l’en-tête de paiement, un wallet compatible GNU Taler) interprète, et tous deux sont des champs facultatifs au sens de la RFC 5322 §3.6.8 : un nom de champ en US-ASCII imprimable suivi d’une valeur non structurée, que tout MTA conforme relaie intact et que tout lecteur conforme ignore s’il ne le reconnaît pas.
Pepsi nomme ses champs d’en-tête d’après leur fonction. Les deux champs de protocole ci-dessus circulent entre déploiements et ne portent pas de préfixe X- : la RFC 6648 déprécie X- parce qu’un champ qui réussit doit être renommé, ce qui casse toute implémentation qui l’a adopté tôt.
Les champs qui ne font qu’annoter un message pour son destinataire local, ou qui portent une demande d’un client de messagerie local, partagent l’espace de noms X-Pepsi-*, qui n’est jamais destiné à atteindre un autre déploiement : X-Pepsi-Crypto, X-Pepsi-Detected-Languages, X-Pepsi-Sign et les autres. pepsi-stage-decrypt retire tout cet espace de noms du courrier entrant, à l’exception du X-Pepsi-Warning propre à ingress, et ingress retire un X-Pepsi-Warning entrant avant d’ajouter le sien, de sorte qu’aucun expéditeur distant ne peut falsifier un verdict local (voir L’injection dans les lignes d’état et la sortie de GnuPG trompe les interfaces ; ce que promet chaque indicateur est indiqué dans Ce que signifie un indicateur de sécurité). La même règle explique pourquoi Pepsi-Origin: doit rester en dehors : une preuve d’origine dans cet espace de noms serait retirée précisément sur le rebond de retour, là où elle est nécessaire. Les champs locaux sont documentés avec l’étape qui les écrit ou les lit, pas ici.
12.1. L’en-tête de preuve d’origine Pepsi-Origin:¶
Lorsque Pepsi relaie un message sortant vers l’extérieur, il l’estampille d’un en-tête Pepsi-Origin: qui prouve cryptographiquement que ce déploiement est à l’origine du message et enregistre lequel de ses expéditeurs autorisés l’a émis. Cela permet de faire confiance à un rebond de retour. Un DSN qui revient des jours plus tard porte dans son corps de rapport le message original, ou une copie de celui-ci, et avec lui l’en-tête Pepsi-Origin:. pepsi-stage-anti-spam peut donc récupérer cet en-tête et confirmer que le rebond répond à un courrier que Pepsi a réellement envoyé, et qu’il ne s’agit pas d’un backscatter ou d’un rebond falsifié visant la barrière de péage à l’envoi.
12.1.1. Syntaxe du champ¶
La valeur de l’en-tête est une liste de champs key=value séparés par ; :
Pepsi-Origin: v=1; host=mail.example.org; sender=alice@example.org;
nonce=<base64url>; ts=<epoch-seconds>; mac=<base64url>
Pepsi-Origin: v=1; host=mail.example.org; sender=alice@example.org;
for=bob@example.com; nonce=<base64url>; ts=<epoch-seconds>; mac=<base64url>
Champ |
Signification |
|---|---|
|
Version du format ; un vérificateur n’accepte que |
|
Le nom d’hôte du déploiement d’origine ( |
|
Le compte expéditeur d’enveloppe autorisé dont le message est issu. |
|
Uniquement sur le courrier que Pepsi a injecté lui-même (voir ci-dessous) : les destinataires d’enveloppe du message, en minuscules, triés et séparés par des virgules. |
|
Un nonce aléatoire de 128 bits, encodé en base64url (RFC 4648, sans remplissage). |
|
L’horodatage Unix (en secondes) auquel l’en-tête a été frappé. |
|
|
Le MAC couvre la version, le nom d’hôte, le compte expéditeur, le nonce et l’horodatage, chaque champ étant préfixé de sa longueur u32 en big-endian puis concaténé, de sorte qu’aucune frontière de champ ne peut être déplacée. Un en-tête avec for ajoute deux champs de plus, le littéral for et la liste des destinataires, si bien que le champ ne peut ni être ajouté à un en-tête ordinaire, ni être retiré d’un en-tête qui le porte, ni y être modifié. Le nom d’hôte est à la fois transporté en clair et intégré au MAC : la copie en clair permet à un vérificateur de rejeter à bas coût un rebond frappé pour un autre déploiement Pepsi, avant toute consultation de la base de données, tandis que son intégration au MAC signifie qu’un en-tête capturé ne peut être rejoué contre un déploiement frère qui partagerait par hasard un secret. Comme seul Pepsi génère ou vérifie ces en-têtes, le format sur le fil n’a besoin d’interopérer avec rien.
12.1.2. Frappe et vérification¶
Estampillage. Quel que soit le chemin sortant qu’emprunte un message, l’étape de relais ajoute l’en-tête en tête du message : pepsi-stage-relay-to-internet et pepsi-stage-relay-to-smarthost appellent toutes deux le moteur partagé
pepsi-common::originet notent le nonce fraîchement frappé dans la tablepepsi.origin_nonceavec une expiration de deux semaines. Si la fonctionnalité est désactivée, le message est inchangé. Si le nonce ne peut pas être enregistré, l’étape réessaie le message plus tard au lieu d’envoyer une estampille qu’elle refuserait ensuite de reconnaître.Vérification. pepsi-stage-anti-spam, sur un rebond de retour, parcourt le message entier (l’en-tête se trouve dans le corps du DSN, pas dans le bloc d’en-têtes propre au rebond), déplie d’éventuelles lignes de continuation et accepte le premier en-tête dont la version et le nom d’hôte correspondent et dont le MAC se vérifie sous le secret. Ce n’est que si la vérification cryptographique à bas coût réussit que la consultation (plus lente) de
pepsi.origin_noncea lieu ; un rebond ne se vérifie que si son nonce est encore suivi. Un rebond ne se vérifie pas si son en-tête manque, est falsifié ou a expiré, et aucun rebond ne se vérifie lorsque la preuve d’origine n’est pas configurée. Un tel rebond est acheminé vers leBOUNCE_TARGET_STAGEde l’étape lorsqu’une telle étape est câblée (l’assistant câble le puitsdiscard-rejected, si bien qu’un tel rebond est abandonné ; une étape de quarantaine le conserve pour examen), et transféré tel quel versNEXT_STAGEdans le cas contraire. Un rebond authentique est toujours transféré normalement. Un rebond n’est jamais soumis à une barrière de paiement.Courrier injecté par Pepsi lui-même. Les notifications de lien et de PIN du portail de lien sécurisé sont des messages que le déploiement compose pour son propre compte avec un expéditeur d’enveloppe humain. Un tel message est estampillé avec la forme
forà son injection et lié à ses destinataires d’enveloppe, et son nonce est enregistré. Lorsqu’un tel message revient par le MX de ce déploiement vers une boîte aux lettres soumise à la barrière, pepsi-stage-anti-spam le transfère sans barrière de paiement si un en-tête du propre bloc d’en-têtes du message se vérifie, porte unfornommant chaque destinataire d’enveloppe de la ligne, et a un nonce suivi. La forme ordinaire, que détient chaque destinataire de notre courrier, n’exempte jamais ; la formeforne peut être rejouée que par ses destinataires, sur du courrier qui leur est adressé. L’adversaire auquel cela répond est l’expéditeur distant de Un expéditeur distant.
12.1.3. Configuration¶
Le matériel de clé réside dans la section partagée [pepsi-origin] (SECRET / SECRET_FILE, plus le [pepsi-ingress] HOSTNAME requis qui est intégré à chaque MAC). La fonctionnalité est activée par défaut : lorsqu’aucun secret n’est configuré, pepsi-setup en provisionne un aléatoire au premier lancement. Le secret doit rester stable dans le temps (un rebond renvoyé des jours plus tard doit encore se vérifier) et être identique sur toutes les instances d’un déploiement.
Pour désactiver la fonctionnalité, positionnez ENABLED = no dans [pepsi-origin]. Le courrier sortant n’est alors plus estampillé, chaque rebond est invérifiable (acheminé selon le BOUNCE_TARGET_STAGE de l’étape anti-spam, sinon transmis) et pepsi-setup ne génère aucun secret ; un secrets.d/pepsi-origin.secret existant est laissé en place, de sorte que la réactiver reprend avec la même clé. Supprimer la section n’est pas un interrupteur d’arrêt : le prochain pepsi-setup run ne trouverait aucun secret et en provisionnerait un nouveau. Voir pepsi-stage-anti-spam et pepsi.conf(5).
12.2. L’en-tête de paiement Taler:¶
Lorsque pepsi-stage-anti-spam retient un message en attente de paiement, il génère une réponse automatique de demande de paiement à l’expéditeur (Auto-Submitted: auto-replied selon la RFC 3834, expéditeur d’enveloppe nul). Cette réponse porte l’URI de paiement GNU Taler
Taler: taler://pay/<backend>/<order-id>/
sous forme de champ d’en-tête, et dans son corps comme lien cliquable et code QR PNG cid: en ligne (la RFC 2392 pour la référence cid:), accompagné d’un pointeur vers https://wallet.taler.net/ pour les expéditeurs sans wallet. L’en-tête est ajouté à côté de la copie du corps, jamais à sa place, de sorte qu’un lecteur humain et un client non-Taler ne sont nullement affectés.
La valeur est exactement l’URI que l’étape frappe, avec order_id == token, de sorte qu’un wallet résout le bon de commande auprès du backend marchand comme il le ferait depuis le lien du corps. taler:// n’est pas un schéma d’URI enregistré à l’IANA (la RFC 7595 en fixe la procédure) ; c’est celui propre à GNU Taler, et la forme sur le fil est documentée par ce projet plutôt qu’ici.
12.2.1. Pourquoi un en-tête et pas seulement le corps¶
L’en-tête est ce qui rend la demande détectable par une machine, et Pepsi est lui-même la machine qui la lit. pepsi-stage-auto-pay est le pendant côté émission et s’exécute sur le chemin entrant. Il reconnaît une demande de paiement de retour à ce champ : il déplie les lignes de continuation, accepte plusieurs URI dans un même champ et plusieurs champs ``Taler:`` (un message adressé à une liste peut susciter plus d’une demande), et ignore les URI taler:// de tout autre type, de sorte que seules de véritables demandes de paiement sont réglées.
La détection seule n’est pas une autorisation. L’étape ne paie que pour du courrier dont ce déploiement peut prouver qu’il est à l’origine. Elle l’établit avec l’en-tête Pepsi-Origin: décrit ci-dessus, qu’elle récupère dans le message renvoyé et vérifie contre pepsi.origin_nonce. Le budget est imputé à ce nonce d’origine, de sorte qu’un même message original ne peut être facturé deux fois.
La réponse recopie aussi verbatim l’en-tête Pepsi-Origin: du message original, ce qui permet à la corrélation de survivre à l’aller-retour.
12.2.2. Interaction avec DKIM et ARC¶
La réponse automatique est injectée à BLOCK_RESPONSE_STAGE : elle est donc signée en DKIM en sortant, comme tout autre message. Le fait que le champ Taler: soit couvert par cette signature suit la configuration h= ordinaire de l’étape (SIGNED_HEADERS, voir pepsi-stage-dkim-sign), dont la valeur par défaut ne l’inclut pas ; il ne fait l’objet d’aucun traitement particulier. Comme la sélection des en-têtes DKIM se fait de bas en haut (RFC 6376 §5.4.2), ajouter le champ ne perturbe aucune signature déjà présente.
12.3. Voir aussi¶
pepsi-stage-anti-spam, pepsi-stage-auto-pay, pepsi-stage-relay-to-internet, pepsi-stage-relay-to-smarthost, Fonctionnalités prises en charge, Index des RFC.