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) etARC-Seal(AS) — sous l’identitéARC_DOMAIN, signé avec l”uniqueARC_ALGORITHM(rsaoued25519; ARC permet une signature par saut).AAR issu du verdict à la frontière : l’AAR réutilise le fragment
Authentication-Resultsqu’ingress a stocké sousstate.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 lignearc=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 colonneheadersest 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 ensemblei=1; cv=none. Une chaîne dont le dernier sceau indique déjàcv=failne 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éecv=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). Sinonstate.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) etremote_ip(sans lui, l’AAR ne porte aucun résultatarc=).state.mime_normalise: lorsqu’il est vrai, les anomalies MIME de classe douce du message sont réécrites ici.Sorties : écrase
state.auth.arcavec le verdict de chaîne réévalué et enregistre les domaines scelleurs de la chaîne sousstate.auth.arc_sealers(le reste destate, y compris les autres voisins destate.authetstate.dsn, est préservé). Pour une chaîne qui s’est validée,arc_sealersne 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 exigerstate.auth.arc == "pass". Pendant qu’untemperrorDNS est attendu,state.arc_temperrorscompte les pauses. Après la réécriture MIME différée,state.mime_normalisevautfalseetstate.mime_normalisedvautpepsi-stage-arc.
35.5. Voir aussi¶
pepsi-ingress, pepsi-stage-dkim-sign, Fonctionnalités prises en charge, pepsi-stage-arc(1).