35. pepsi-stage-arc

Vérification, signature et scellement ARC — l’étape d’entrée du chemin entrant.

35.1. Rôle

pepsi-stage-arc implémente ARC (RFC 8617). Elle vérifie toute chaîne ARC entrante existante et, lorsqu’un ARC_DOMAIN et ses clés sont configurés, scelle le message en tant que notre ADMD afin que le verdict d’authentification pris à la limite survive au saut de redirection de Pepsi. Comme elle ne s’applique qu’au courrier que nous recevons et redirigeons, elle ne doit jamais toucher nos propres soumissions (state.local_origin). C’est pepsi-stage-dkim-sign qui signe celles-ci comme domaine auteur, et cette étape ignore tout message de ce type. Sur un hôte qui à la fois reçoit et soumet, placez-la sur la branche entrante uniquement, après la scission state.local_origin (en amont de SRS) ; sur un hôte en réception seule, elle est l’étape [stage-init]. Référence : pepsi-stage-arc(1).

35.2. Fonctionnalités

  • Vérification ARC de toute chaîne entrante ; le verdict est noté sous state.auth.arc.

  • Scellement ARC : ajoute en tête un nouvel ensemble ARC — ARC-Authentication-Results (AAR), ARC-Message-Signature (AMS) et ARC-Seal (AS) — sous l’identité ARC_DOMAIN, signé avec l”unique ARC_ALGORITHM (rsa ou ed25519 ; ARC permet une signature par saut).

  • AAR issu du verdict à la frontière : l’AAR réutilise le fragment Authentication-Results qu’ingress a stocké sous state.origin.ar_results, de sorte que SPF/DKIM/DMARC sont vérifiés exactement une fois, à l’ingress. Seule la chaîne ARC entrante est vérifiée ici, pour calculer la valeur de validation de chaîne (cv=) et la ligne arc= de l’AAR.

  • Ajout en tête uniquement : le sceau est ajouté en haut, de sorte que les signatures inférieures existantes et l’en-tête Received: de l’ingress ne sont pas perturbés ; seule la colonne headers est réécrite, jamais le corps, sauf pour l’unique réécriture décrite ci-dessous.

  • La réécriture MIME différée : un message que l’ingress a marqué state.mime_normalise (MIME ambigu arrivé avec une chaîne ARC) est réécrit ici selon sa lecture RFC. La réécriture a lieu après la vérification de la chaîne sur les octets tels que reçus, et avant le sceau. Ainsi, cv= reflète la chaîne telle qu’elle est arrivée et le sceau couvre ce qui est stocké (Le MIME ambigu est tranché à la frontière). Elle s’applique sur tout chemin d’avancée, scellé ou non.

  • Fail-open : si le contexte d’origine, la config [pepsi] ou les clés manquent, ou si le scellement échoue, le message est avancé non scellé avec un avertissement (le verdict est tout de même noté lorsqu’il est calculable). Seul un démon de signature injoignable le fait attendre et réessayer.

  • cv=fail pour toute chaîne cassée (RFC 8617 section 5.2), y compris une chaîne qui ne s’analyse pas ou dont les ensembles sont signés avec rsa-sha1 (RFC 8301), de sorte qu’une chaîne cassée n’est jamais blanchie en un nouvel ensemble i=1; cv=none. Une chaîne dont le dernier sceau indique déjà cv=fail ne reçoit pas d’ensemble supplémentaire.

  • Un temperror DNS est attendu : une chaîne qui n’a pu être validée qu’à cause de l’échec d’une recherche de clé est mise en pause cinq minutes et réessayée, au plus trois fois (comptées dans state.arc_temperrors), avant d’être scellée cv=fail.

35.3. Configuration

[stage-<name>] : PROGRAM = pepsi-stage-arc, NEXT_STAGE (obligatoire : l’étape transmet toujours le message, si bien qu’une valeur manquante fait échouer chaque message), les paramètres DNS DNS_SERVERS (vide = [pepsi] DNS_SERVERS, sinon le résolveur système ; entrées simples, tls:// ou https://) / DNS_TIMEOUT, et les paramètres de signature partagés HEADER_CANONICALIZATION / BODY_CANONICALIZATION (relaxed par défaut, ou simple), SIGNED_HEADERS (qui doit inclure From ; la valeur par défaut couvre DKIM-Signature lorsque le message en porte un) et SIGNATURE_EXPIRATION_DAYS (pas de x= par défaut) appliqués à l’AMS (l’ARC-Seal est toujours canonisé en mode relaxed sur son ensemble fixe d’en-têtes et ne porte pas de x=, selon la RFC 8617). L’identité de signature et l’algorithme proviennent de la section partagée [pepsi] (ARC_DOMAIN, ARC_ALGORITHM). Voir pepsi-stage-arc(1).

Le sceau est produit avec la clé correspondant à ARC_DOMAIN et ARC_ALGORITHM, que détient pepsi-dkim(1) et avec laquelle il signe ; l’étape construit l”ARC-Message-Signature et l”ARC-Seal et envoie le bloc d’en-têtes à la socket du démon. Sans ARC_DOMAIN, ou lorsque le démon ne signe pas pour lui, le message est avancé non scellé ; lorsque le démon est injoignable, il est réessayé. Une étape compromise ne peut pas copier la clé mais peut faire produire des sceaux tant qu’elle s’exécute, de sorte qu’un sceau ne vaut que ce que vaut le rôle pepsi (Un composant compromis). Une chaîne valide ne confère aucune confiance par elle-même (RFC 8617 §8.4) : une politique locale, telle que les lignes sealer_domain de pepsi-stage-check-whitelist, s’appuie sur state.auth.arc_sealers. L’étape protège la réputation du domaine, pas une préférence d’utilisateur ; ne l’inscrivez jamais dans EDITABLE_STAGES (Les paramètres par adresse sont une frontière de confiance).

35.4. État

  • Entrées : state.local_origin : lorsqu’il est vrai, le message est avancé sans être touché (pas d’ARC sur le courrier que nous émettons). Sinon state.origin, avec l”authserv_id (requis pour reproduire l’identité de l’AAR ; sans lui, l’étape avance non scellée), ar_results (réutilisé dans l’AAR) et remote_ip (sans lui, l’AAR ne porte aucun résultat arc=). state.mime_normalise : lorsqu’il est vrai, les anomalies MIME de classe douce du message sont réécrites ici.

  • Sorties : écrase state.auth.arc avec le verdict de chaîne réévalué et enregistre les domaines scelleurs de la chaîne sous state.auth.arc_sealers (le reste de state, y compris les autres voisins de state.auth et state.dsn, est préservé). Pour une chaîne qui s’est validée, arc_sealers ne liste que les scelleurs dont le propre ARC-Message-Signature se vérifie encore sur le message (la validation de chaîne ne vérifie que le plus récent, de sorte qu’un ensemble copié d’un autre message nommerait sinon un scelleur qui n’a jamais vu ces octets) ; pour une chaîne qui ne s’est pas validée, elle liste chaque scelleur prétendu, de sorte que tout lecteur doit d’abord exiger state.auth.arc == "pass". Pendant qu’un temperror DNS est attendu, state.arc_temperrors compte les pauses. Après la réécriture MIME différée, state.mime_normalise vaut false et state.mime_normalised vaut pepsi-stage-arc.

35.5. Voir aussi

pepsi-ingress, pepsi-stage-dkim-sign, Fonctionnalités prises en charge, pepsi-stage-arc(1).