95.1.4. pepsi-stage-arc¶
ARC-verify, sign and seal in the Pepsi pipeline
- Section du manuel:
1
95.1.4.1.1. Nom¶
pepsi-stage-arc - l’étape de vérification et de scellement ARC du pipeline Pepsi.
95.1.4.1.2. Synopsis¶
pepsi-stage-arc [GLOBAL-OPTIONS] worker
95.1.4.1.3. Description¶
pepsi-stage-arc est un programme d’étape que pepsi-dispatch(1) exécute comme un worker persistant ; ce worker lit les identifiants de message sur l’entrée standard. Il implémente ARC (RFC 8617) : il vérifie toute chaîne ARC entrante existante et note le verdict obtenu dans le state.auth.arc de la ligne. Lorsqu’une identité de signature ARC est configurée, il scelle aussi le message en tant que notre ADMD, en ajoutant en tête un nouvel ensemble ARC : ARC-Authentication-Results (AAR), ARC-Message-Signature (AMS) et ARC-Seal (AS). Le scellement ne fait qu”ajouter en tête des lignes d’en-tête, de sorte que les signatures existantes plus bas dans le message ne sont pas perturbées ; la seule modification de contenu que fait cette étape est la réécriture MIME décrite ci-dessous. La ligne avance ensuite vers son NEXT_STAGE. Le reste du state de la ligne, y compris d’éventuels paramètres state.dsn RFC 3461, est laissé intact pour que les étapes ultérieures l’honorent.
La signature ARC est une étape et non une partie de pepsi-ingress(1) : ainsi l’ingress ne détient pas les clés de signature ARC. L’ingress vérifie SPF, DKIM et DMARC, écrit l’en-tête Authentication-Results autonome, et note le texte de résultat rendu sous state.origin.ar_results ; cette étape n’ajoute que l’ensemble ARC. L’AAR (qui, selon la RFC 8617, devrait refléter l’évaluation complète du récepteur) est construit à partir de ce fragment stocké, tel quel. SPF, DKIM et DMARC ne sont donc pas vérifiés une seconde fois ici, et le travail qui demande de nombreuses requêtes DNS est effectué exactement une fois. Cette étape ne vérifie que la chaîne ARC entrante, que l’ingress n’évalue pas : elle calcule ainsi la valeur de validation de chaîne (cv=) et ajoute sa propre ligne arc= à l’AAR.
Une réécriture est faite ici plutôt que dans l’ingress. Un message dont la structure MIME présente une anomalie de classe douce (pepsi-ingress(1), « Ambiguous MIME structure ») est normalement réécrit par l’ingress selon sa lecture RFC avant d’être stocké. Un message arrivé porteur d’une chaîne ARC est au contraire stocké tel qu’il a été reçu et marqué state.mime_normalise : la chaîne doit être vérifiée sur les octets que ses scelleurs ont signés, tandis que notre sceau doit couvrir ce qui est stocké à partir d’ici. Cette étape vérifie la chaîne sur le message tel que reçu, le réécrit (pepsi_common::mime_anomaly), et scelle le message réécrit, de sorte que cv= reflète la chaîne telle qu’elle est arrivée et que l”ARC-Message-Signature couvre les octets stockés. Pour un tel message, les colonnes headers et body sont toutes deux réécrites, state.mime_normalise est mis à false et state.mime_normalised à pepsi-stage-arc. La réécriture est appliquée sur tout chemin d’avancée, scellé ou non ; une pause sur temperror DNS laisse la ligne telle qu’elle était.
95.1.4.1.4. Qui a scellé la chaîne : state.auth.arc_sealers¶
Outre le verdict, l’étape note le d= des champs ARC-Seal que le message portait à son arrivée. Elle les stocke sous forme de tableau JSON sous state.auth.arc_sealers : en minuscules, sans éventuel point racine final, sans doublons et ordonnés par instance, de sorte que l’ADMD le plus proche de l’auteur vienne en premier. Notre propre ARC_DOMAIN n’y figure jamais : la liste est lue dans le message avant que l’étape ne rende son propre ensemble, de sorte qu’un sceau que nous avons ajouté ne peut satisfaire une règle portant sur des intermédiaires.
Ceci existe parce que state.auth.arc ne peut pas répondre à la question que se pose réellement un destinataire. La RFC 8617 §8.4 est explicite : une chaîne valide ne confère aucune fiabilité. Elle établit seulement que les ADMD qui y sont nommés ont manipulé le message, et laisse délibérément à la politique locale la question de savoir si ces ADMD sont honnêtes. Un destinataire qui veut excuser le SPF ou le DKIM cassé d’un saut de redirection doit donc nommer les sauts qu’il accepte, et il lui faut un endroit où lire ces sauts. Cette clé est cet endroit ; les lignes sealer_domain de pepsi-stage-check-whitelist(1) sont la politique écrite à partir d’elle.
Pour une chaîne qui s’est validée, le tableau ne contient que les scelleurs dont le propre ARC-Message-Signature se vérifie encore sur le message tel qu’il est arrivé. La RFC 8617 section 5.2 ne vérifie que l’AMS le plus récent ; les ensembles plus anciens sont tenus en place par les sceaux, et un sceau signe les champs d’en-tête ARC, pas le message. N’importe qui peut donc copier un ensemble authentique sur une vraie contribution de lists.example.org, le placer au-dessus d’un contenu de son cru et sceller le résultat avec sa propre clé : la chaîne se valide et nomme lists.example.org, qui n’a jamais vu ces octets. Vérifier l’AMS de chaque scelleur est ce qui fait que la liste signifie « a signé ce contenu » plutôt que « apparaît dans une chaîne valide ». Le coût est qu’un saut ultérieur qui réécrit le message (une étiquette d’objet, un pied de page) fait disparaître de la liste les scelleurs antérieurs, ce qui est juste : ce saut aurait pu réécrire n’importe quoi.
Pour une chaîne qui ne s’est pas validée, le tableau contient chaque scelleur revendiqué. Un d= non validé est une revendication, et l’opérateur qui diagnostique un message rejeté a besoin de la trace de ce qui a été revendiqué. Tout ce qui exploite le tableau doit donc exiger d’abord state.auth.arc = pass. check-whitelist le fait et écarte sinon toute la liste, de sorte qu’une chaîne frappée par n’importe qui ne peut nommer un scelleur digne de confiance.
95.1.4.1.5. Validation de la chaîne et cv=¶
La RFC 8617 §5.2 définit trois résultats de validation de chaîne, et la balise cv= de l”ARC-Seal que cette étape ajoute indique lequel s’applique au message tel qu’il est arrivé :
cv=noneAucune chaîne ARC n’était présente : cet ADMD est le premier à sceller ce message.
cv=passUne chaîne était présente et chaque ensemble s’est validé.
cv=failUne chaîne était présente et ne s’est pas validée.
cv=none est une assertion sur la provenance plutôt qu’une absence : elle indique au récepteur suivant que rien en amont ne s’était déjà porté garant de ce message. L’émettre par-dessus une chaîne présente mais cassée blanchirait cette chaîne : le validateur en aval verrait un ensemble i=1 apparemment immaculé et aucune trace d’une quelconque altération.
Pepsi scelle donc cv=fail pour toute chaîne entrante qui ne se valide pas, y compris dans les cas où la chaîne ne peut pas être lue du tout : un en-tête ARC-Seal/ARC-Message-Signature/ARC-Authentication-Results qui ne s’analyse pas, une chaîne plus longue que les 50 ensembles que la RFC 8617 autorise, et une chaîne comportant des nombres inégaux des trois types d’en-tête. Un ensemble scellé ou signé avec rsa-sha1 ne se valide pas non plus : la RFC 8301 fait de cet algorithme un permerror pour DKIM, et les sceaux et signatures de message ARC utilisent les algorithmes DKIM. Le nouvel ensemble poursuit la numérotation d’instance de la chaîne au lieu de la redémarrer à i=1.
La seule exception est une chaîne dont l”ARC-Seal le plus récent indique déjà cv=fail. Selon la RFC 8617 §5.1.1, une chaîne en échec ne peut pas être réparée et ce sceau est le dernier ; cette étape n’ajoute donc aucun ensemble et le message est redirigé avec la chaîne en l’état.
Une chaîne qui n’a pu être validée qu’en raison de l’échec d’une recherche de clé (un temperror DNS) n’est pas scellée immédiatement : ce cv=fail serait faux au sujet d’une chaîne peut-être saine, et un sceau ne peut être repris. Le message est mis en pause cinq minutes puis réessayé, jusqu’à trois fois (environ un quart d’heure, compté dans state.arc_temperrors) ; si les recherches échouent toujours, il est alors scellé cv=fail comme toute autre chaîne qui ne se valide pas.
Le sceau a besoin d’un peu de contexte venu de la session SMTP : l”authserv-id, le fragment Authentication-Results rendu et l’adresse IP du client qui se connecte. L’étape le lit dans les métadonnées d’origine SMTP que l’ingress a notées sous le state.origin de la ligne. C’est ainsi que l’ingress transmet l’information à cette étape.
L’ensemble ARC est signé avec la clé du domaine [pepsi] ARC_DOMAIN pour l’unique algorithme que nomme [pepsi] ARC_ALGORITHM (ARC n’autorise qu’une signature par saut). L’étape ne détient aucune clé : c’est le démon de signature pepsi-dkim(1) qui la détient, sous son propre compte. L’étape construit les champs ARC-Message-Signature et ARC-Seal et envoie chaque bloc d’en-têtes canonisé à la socket du démon ([pepsi-dkim] SOCKET), qui ne signe que pour ARC_DOMAIN. Une étape compromise ne peut donc pas copier la clé, mais tout processus du groupe pepsi peut interroger la socket, de sorte qu’un sceau ne vaut que ce que vaut ce rôle (voir le chapitre Modèle de menace du manuel). L’étape protège la réputation du domaine, pas une préférence d’utilisateur ; ne l’inscrivez donc pas dans les EDITABLE_STAGES de pepsi-stage-edit-settings(1).
ARC ne s’applique qu’au courrier que nous recevons et redirigeons : il préserve l’authentification d’un ADMD en amont à travers notre saut. Il ne doit donc jamais toucher le courrier que nous émettons, c’est-à-dire nos propres soumissions authentifiées (state.local_origin) ; c’est pepsi-stage-dkim-sign(1) qui les authentifie comme domaine auteur. Sceller un tel message ne ferait que publier les propres verdicts SPF/DKIM/DMARC de la soumission (typiquement un SPF fail pour un client itinérant absent de notre enregistrement SPF) à l’intérieur de l’ensemble ARC. L’étape ignore donc tout message state.local_origin qu’elle reçoit et le fait avancer non scellé ; cela rend l’étape sûre où qu’elle soit placée. Sur un hôte qui à la fois reçoit et soumet, placez-la sur la branche entrante uniquement, après la scission selon state.local_origin, pour qu’elle ne voie que le courrier reçu, et avant la réécriture d’enveloppe SRS et toute autre transformation. Sur un hôte en réception seule, elle est naturellement l’étape initiale ([stage-init]).
Le scellement est fail-open là où il n’y a rien avec quoi sceller : si le contexte d’origine est manquant, si la configuration [pepsi] ne peut pas être lue, si aucun ARC_DOMAIN n’est défini, si pepsi-dkim(1) ne signe pas pour lui ou ne détient aucune clé d”ARC_ALGORITHM, ou si le résolveur ne peut être mis en place, le message est avancé non scellé avec un avertissement plutôt que d’être retenu (le verdict ARC est tout de même enregistré chaque fois qu’il a pu être calculé). Un démon de signature injoignable est une autre affaire : c’est la faute de l’hôte, et le message est mis en pause et réessayé comme toute erreur d’étape jusqu’au MAX_LIFETIME de l’étape, jamais avancé non scellé pour cette raison. La section propre de l’étape est l’autre exception : elle est vérifiée au démarrage du worker, et une section qui ne s’analyse pas fait refuser au worker de démarrer (sortie 78). Le dispatcher retient alors la file jusqu’à ce que la section soit corrigée, au lieu de laisser passer chaque message non scellé.
95.1.4.1.6. Configuration¶
L’étape est câblée et configurée via sa propre section [stage-<name>] (PROGRAM = pepsi-stage-arc, un NEXT_STAGE obligatoire). Ses options sont les paramètres DNS (DNS_SERVERS, DNS_TIMEOUT) et les paramètres de signature de l’ensemble ARC : HEADER_CANONICALIZATION, BODY_CANONICALIZATION, SIGNATURE_EXPIRATION_DAYS et SIGNED_HEADERS ; la valeur par défaut de SIGNED_HEADERS ajoute DKIM-Signature à l’ensemble de l’étape DKIM et omet la paire List-Unsubscribe. pepsi.conf(5) les documente avec l’identité de signature partagée [pepsi] (ARC_DOMAIN, ARC_ALGORITHM). La clé et son sélecteur relèvent de pepsi-dkim(1).
95.1.4.1.7. État¶
Entrées : state.local_origin : lorsqu’il est vrai, le message est l’une de nos propres soumissions et est avancé sans être touché (pas d’ARC). Sinon state.origin, les métadonnées d’origine SMTP que l’ingress a enregistrées. L”authserv_id est requis pour reproduire l’identité de l’AAR (sans lui, l’étape avance non scellée, fail-open) ; ar_results porte le fragment Authentication-Results rendu par l’ingress, réutilisé tel quel dans l’AAR de sorte que SPF/DKIM/DMARC n’aient pas à être re-vérifiés ; remote_ip est nécessaire pour le propre résultat arc= de l’AAR, qui est omis lorsqu’il est absent (injection locale). helo est lu mais ne modifie pas l’ensemble.
Sorties : l’étape écrase state.auth.arc avec le verdict de chaîne réévalué (elle remplace le none que l’ingress y inscrit), écrit state.auth.arc_sealers (voir ci-dessus) et ajoute en tête l’ensemble ARC à la colonne headers ; le reste de state, y compris les autres verdicts state.auth et state.dsn, est préservé inchangé. Pendant qu’elle attend la fin d’un temperror DNS, elle compte les tentatives dans state.arc_temperrors. La disposition de l’état est décrite dans pepsi.state(7).
Transitions : avance vers NEXT_STAGE : après avoir ajouté en tête l’ensemble ARC, après avoir simplement noté le verdict dans state.auth.arc lorsqu’aucune identité de signature n’est configurée, ou immédiatement (sans y toucher) pour un message state.local_origin, qui n’est jamais traité par ARC. La seule autre issue est une pause de cinq minutes, au plus trois fois, pour une chaîne entrante dont la validation a rencontré un temperror DNS (voir ci-dessus). Il n’y a pas de branche ; l’étape n’échoue jamais, ne réachemine ni ne termine jamais un message.
95.1.4.1.8. Commandes¶
Exécuté comme worker, le programme vérifie et scelle chaque message et le fait avancer.
95.1.4.1.9. Options globales¶
- -c FILE, –config FILE
Lit la configuration depuis FILE au lieu du chemin de recherche par défaut.
- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de journalisation (
error,warn,info,debug,trace; par défaut[pepsi] LOG, sinoninfo).- -h, –help
Affiche un résumé d’utilisation et quitte.
- -V, –version
Affiche la version et quitte.
95.1.4.1.10. 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, base de données impossible à ouvrir, ou échec de l’entrée/sortie standard). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer : sa section ne s’analyse pas. Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.
95.1.4.1.11. Voir aussi¶
pepsi-config(1), pepsi-ingress(1), pepsi-stage-srs(1), pepsi-stage-dkim-sign(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1), pepsi-dkim(1)
95.1.4.1.12. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.