39. pepsi-stage-dkim-sign¶
Ajouter les signatures DKIM en tête avant la remise.
39.1. Rôle¶
pepsi-stage-dkim-sign signe le message avec DKIM et l’avance vers une étape de remise. Séparer la signature de la construction du message permet à pepsi-stage-bounce de construire un DSN non signé et de pointer son NEXT_STAGE ici, de sorte qu’un rebond généré est signé avant d’être envoyé. Référence : pepsi-stage-dkim-sign(1).
39.2. Fonctionnalités¶
DKIM à double signature (RFC 6376) : ajoute par défaut en tête à la fois un en-tête
DKIM-SignatureRSA-2048 et un Ed25519 (RFC 8463) ;[pepsi] DKIM_ALGORITHMSréduit cela à un seul (les plus grands destinataires ne vérifient pas Ed25519 et le signalent commefaildans les rapports agrégés DMARC).Sélection du domaine de signature :
SIGNING_DOMAINs’il est défini, sinon le domaine de l’en-têteFrom:du message.Couverture intégrale du corps, toujours : la balise de longueur de corps
l=de la RFC 6376 n’est jamais émise et n’est pas configurable. Les vérificateurs stricts (mail-auth, Stalwart et celui de Pepsi) rejettent purement et simplement une signature avecl > 0, et la RFC 6376 §8.2 avertit qu’un contenu ajouté à la fin peut remplacer l’original aux yeux du lecteur.Ajout en tête uniquement / écriture unique : les signatures sont ajoutées en haut, de sorte que les signatures existantes plus bas dans le message ne sont pas perturbées ; seule la colonne
headersest réécrite, sauf si le corps a été converti (point suivant).7 bits avant la signature (RFC 6376 section 5.3) : un corps 8 bits est réencodé en quoted-printable ou en base64 avant le calcul de la signature, de sorte qu’un prochain saut sans
8BITMIMEn’oblige pas le relais à le réencoder ensuite et à casser la signature. Ce n’est pas fait lorsqu’une autre signature couvre déjà les octets 8 bits (unDKIM-Signatureou unARC-Message-Signaturesur le message, une partiemultipart/signed), ni lorsque les en-têtes du message nécessitentSMTPUTF8.Pas de signature pour une contrefaçon de notre domaine : un message est avancé non signé s’il est arrivé de l’extérieur, si son
From:s’aligne avec le domaine de signature et si l’ingress ne l’a authentifié ni par DMARC ni par une signature DKIM alignée. Ainsi, sa réexpédition ne lui fait pas réussir DMARC au saut suivant. Le courrier soumis ici et le courrier que compose Pepsi (DSN, avis, copies de listes) sont signés comme d’habitude. AvecSIGNING_DOMAIN, le courrier reçu de l’extérieur dont leFrom:ne relève pas de l’organisation de ce domaine (courrier réexpédié d’un auteur étranger) est lui aussi avancé non signé. Le domaine SRS dédié de pepsi-stage-srs couvre la moitié SPF de cette règle ; voir Falsifications de notre propre domaine transférées (Un expéditeur distant).Lecture stricte du ``From:`` : le domaine de signature n’est tiré d’un
From:que lorsque chaque boîte aux lettres qu’il contient s’analyse strictement (CERT/CC VU#517845), de sorte qu’un champ que les clients résolvent en adresses différentes n’est jamais signé au nom du domaine qu’un lecteur indulgent choisirait.Fail-closed : hormis cette règle, un message n’est jamais avancé non signé. Un message ne peut pas être signé si aucun domaine de signature ne peut être déterminé (pas de
SIGNING_DOMAINet pas deFrom:qui ne se lise que d’une seule façon), si pepsi-dkim(1) ne signe pas pour ce domaine, ou si leFrom:d’un message soumis ou composé ici ne relève pas de l’organisation d’unSIGNING_DOMAINconfiguré. Un tel message est scindé en une ligne par destinataire et réacheminé vers leBOUNCE_STAGEde l’étape avec une raison de DSN (5.6.0ou5.7.1). SansBOUNCE_STAGE, ou pour un message à expéditeur nul, il est mis en échec (failedterminal, avec la raison dansstate.last_error), et pepsi-failure-bouncer ou l’opérateur décide de ce qu’il en advient. Si le démon de signature est injoignable ou refuse pour une autre raison, c’est l’hôte qui est en cause : le message est mis en pause et réessayé, avec la raison dansstate.last_error, jusqu’auMAX_LIFETIMEde l’étape (par défaut 120 heures). Démarrezpepsi-dkim.service, et la file se vide d’elle-même.
39.3. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-dkim-sign, NEXT_STAGE (obligatoire) et SIGNING_DOMAIN, plus les paramètres de signature HEADER_CANONICALIZATION / BODY_CANONICALIZATION (relaxed, la valeur par défaut, ou simple, choisissables indépendamment), SIGNED_HEADERS (l’ensemble h= ; doit inclure From ; la valeur par défaut couvre List-Unsubscribe et List-Unsubscribe-Post, comme l’exige la RFC 8058, et sur-signe chaque champ qu’elle nomme, de sorte qu’un second To: ou Reply-To: ajouté en tête casse la signature) et SIGNATURE_EXPIRATION_DAYS (l’étiquette x=, sept jours après la signature par défaut ; 0 n’en émet aucune, voir La durée de vie de nos signatures DKIM). [pepsi] DKIM_ALGORITHMS décide quelles signatures sont produites. Voir pepsi-stage-dkim-sign(1).
L’étape ne détient aucune clé : c’est pepsi-dkim(1) qui les détient, sous son propre compte, et qui signe le bloc d’en-têtes que l’étape construit et envoie à sa socket. Les sélecteurs sont ceux du démon (<DKIM_SELECTOR>-YYYYMM et le même avec -ed25519), et changent lorsqu’il renouvelle les clés. Une étape compromise ne peut donc pas copier une clé, mais elle peut encore faire signer du courrier d’un domaine servi via la socket tant qu’elle s’exécute, de sorte qu’une signature ne vaut que ce que vaut le rôle pepsi (Un composant compromis). 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).
39.4. État¶
Entrées :
state.local_originet les verdicts d’ingressstate.auth.dmarc/state.auth.dkim, qui décident si un message dont leFrom:s’aligne avec le domaine de signature est signé ; le domaine provient deSIGNING_DOMAINou de la colonnefrom_header, l’empreinte du corps du message chargé.Sorties : sur le chemin de signature, seulement
state.origin.body_8bit, effacé lorsque le corps a été converti en 7 bits ; le reste destate, y comprisstate.dsn, est préservé. Sinon, seul un refus ou un réessai écrit quelque chose (state.last_error;state.bouncelors d’un réacheminement versBOUNCE_STAGE;state.temporary_failurespour un réessai).
39.5. Voir aussi¶
pepsi-stage-bounce, pepsi-stage-relay-to-internet, Fonctionnalités prises en charge, pepsi-stage-dkim-sign(1).