Passer au contenu
Français
  • Il n'y a aucune suggestion car le champ de recherche est vide.

Pourquoi les signatures DKIM échouent

Les signatures DKIM échouent généralement pour l’une de ces deux raisons : le message a été modifié après sa signature, ou le destinataire n’a pas trouvé de clé publique exploitable au sélecteur indiqué dans la signature. Les problèmes DNS temporaires et les erreurs de signature expliquent le reste. Chaque cas demande une correction différente. Republier votre enregistrement DNS ne réglera pas un pied de page ajouté après la signature, et modifier votre passerelle de messagerie ne réglera pas un enregistrement manquant. Et si DKIM a réussi mais pas DMARC, ce n’est pas du tout un échec DKIM. C’est une question d’alignement (alignment).

Ce que signifie « DKIM fail »

Lorsqu’un destinataire vérifie une signature, il renvoie soit un échec permanent (PERMFAIL), soit un échec temporaire (TEMPFAIL), avec une courte raison entre crochets, comme « body hash did not verify » ou « no key for signature ». Les destinataires consignent généralement le résultat dans l’en-tête Authentication-Results sous la forme fail, neutral, policy, temperror ou permerror. Une ligne typique :

Authentication-Results: mx.receiver.example;
  dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026

header.d est le domaine signataire et header.s le sélecteur. Ces deux valeurs, plus le texte de la raison, vous indiquent à quelle famille de problèmes vous avez affaire.

Un échec DKIM ne fait pas, à lui seul, rejeter le message par le destinataire. Une signature en échec n’impose pas le rejet. La suite dépend du filtrage du destinataire et de votre politique DMARC. Pour les expéditeurs en masse vers Gmail, en revanche, un échec DKIM a un coût direct. Gmail liste ces réponses :

  • 4.7.30 : « Votre e-mail a fait l’objet d’une limitation de débit, car l’authentification DKIM n’a pas réussi pour ce message. Gmail exige de tous les expéditeurs d’e-mails en masse qu’ils authentifient leurs e-mails avec DKIM. »
  • 5.7.30 : « Ce message a été bloqué, car il n’a pas réussi l’authentification DKIM. Gmail exige des expéditeurs d’e-mails en masse qu’ils authentifient leurs e-mails avec DKIM. »

Les règles plus larges des fournisseurs sont décrites dans Exigences de Google, Yahoo et Microsoft pour les expéditeurs.

Les causes courantes d’échec DKIM

1. Le message a été modifié après la signature (« body hash did not verify »)

Si DKIM « fonctionnait hier », commencez par là.

« Body hash did not verify » signifie que le corps a changé après sa signature. Google le dit clairement : si le texte à côté de l’entrée DKIM est « body hash did not verify », « le message a été modifié pendant le transit ». Coupables habituels :

  • Une passerelle sortante ou un outil de clause de non-responsabilité qui ajoute un pied de page après la signature du message par votre plateforme de messagerie. Google met précisément en garde contre cela.
  • Les outils de réécriture de liens ou de suivi qui modifient le corps après la signature.
  • Les listes de diffusion qui ajoutent des pieds de page (DKIM, listes de diffusion et services de transfert).

Si vous voyez cette erreur dans Microsoft 365, elle signifie la même chose : un élément du parcours a modifié le corps après la signature.

« Signature did not verify » avec un hachage du corps correct peut signifier qu’un en-tête signé a changé. Une liste qui ajoute [tag] à l’objet est le cas classique.

Les changements d’encodage comptent aussi. Convertir un contenu 8 bits en 7 bits pendant le transit casse les signatures DKIM ; les signataires devraient donc encoder le message avant de le signer, tel qu’il est censé être reçu.

La canonisation compte. simple casse à la moindre modification ; relaxed tolère les espaces et les en-têtes remis en forme, mais pas les modifications de contenu. Microsoft 365 utilise relaxed par défaut pour l’en-tête comme pour le corps.

La correction : signez après le dernier système qui modifie le message, ou empêchez ce système de toucher au contenu signé. Le même conseil vaut pour les listes de diffusion : signer une fois le message préparé pour la diffusion. Ne modifiez pas le DNS et ne régénérez pas les clés. Ni l’un ni l’autre n’aide un corps qui a été réécrit.

2. Le destinataire ne trouve pas la clé ou ne peut pas la lire

Le destinataire interroge exactement <s=>._domainkey.<d=>. Si cette requête échoue, le résultat dépend de la raison :

  • No key for signature (PERMFAIL). Rien n’est publié à ce nom. La clé n’a jamais été publiée, elle a été saisie sous le mauvais nom d’hôte (Microsoft signale le domaine en double, comme selector1._domainkey.example.com.example.com), elle se trouve dans la mauvaise zone DNS, le sélecteur est mal orthographié, ou la clé a été supprimée trop tôt lors d’un renouvellement (Comment effectuer la rotation d’une clé DKIM). Si l’expéditeur signe avec un sélecteur ou un domaine d= que vous n’avez jamais publié, vous arrivez aussi ici. Le diagnostic complet de l’absence d’enregistrement se trouve dans Signature DKIM introuvable.
  • Key unavailable (TEMPFAIL). Le DNS n’a pas répondu. C’est le seul cas où une réponse SMTP temporaire 4xx est appropriée. Pour Microsoft 365, des dkim=temperror intermittents sont souvent liés à des TTL très bas sur les CNAME DKIM ; un TTL d’au moins 3600 secondes est recommandé.
  • Key syntax error (PERMFAIL). L’enregistrement est mal formé. Le cas classique est une clé de 2048 bits coupée à 255 caractères, ou des chaînes découpées stockées dans le désordre (Clés DKIM de 1024 bits ou de 2048 bits).
  • Key revoked (PERMFAIL). L’enregistrement a un p= vide. C’est un retrait délibéré : les e-mails encore signés avec cette clé échouent donc.
  • Mauvais type d’enregistrement. Un TXT là où le fournisseur attend un CNAME, ou un CNAME en proxy via Cloudflare au lieu d’être en mode DNS uniquement.
  • Trop tôt. Une nouvelle clé peut mettre jusqu’à 48 heures à fonctionner.

Les formats d’enregistrement et le piège du domaine en double sont décrits dans Sélecteurs DKIM et enregistrements DNS.

3. La signature elle-même est mal configurée

Ce sont des problèmes de configuration du signataire, et ce sont des échecs permanents :

  • Une balise obligatoire manque (v, a, b, bh, d, h, s).
  • L’en-tête From ne figure pas dans h= (« From field not signed »).
  • Le domaine i= n’est ni le domaine d= ni l’un de ses sous-domaines (« domain mismatch »).
  • La signature a expiré (x= est dans le passé). Les vérificateurs peuvent la faire échouer, ce qui concerne surtout les e-mails très retardés ou rejoués.
  • L’algorithme est rsa-sha1, qui échoue désormais définitivement à l’évaluation, ou la clé RSA fait moins de 1024 bits.

Deux paramètres connexes méritent aussi une vérification :

  • La balise de longueur du corps l= laisse non vérifié le contenu au-delà de la limite. Cela peut être exploité, et les évaluateurs peuvent ignorer les signatures qui utilisent cette balise. N’utilisez pas l=, car les messages qui l’utilisent sont exposés aux abus.
  • Un enregistrement de clé avec t=y (test) n’est pas un échec, mais les destinataires doivent traiter l’e-mail comme non signé : vous ne tirez donc aucun bénéfice de DKIM.

Si vous envoyez des e-mails marketing avec désinscription en un clic, vérifiez aussi que h= contient les en-têtes de liste. Le message doit porter une signature DKIM valide couvrant au moins List-Unsubscribe et List-Unsubscribe-Post.

4. L’échec est survenu après le départ du message

Un simple transfert préserve généralement DKIM. Les listes de diffusion qui marquent l’objet, ajoutent des pieds de page ou réécrivent les parties MIME le cassent généralement. Les messages transférés peuvent échouer à DKIM même si votre configuration est correcte. Vous ne pouvez pas entièrement corriger cela côté envoi. Voir DKIM, listes de diffusion et services de transfert.

Quand DKIM a réussi pour le mauvais domaine

Il arrive que le rapport indique dkim=pass alors que DMARC ne réussit toujours pas. Ce n’est pas un échec DKIM. La signature a été vérifiée, mais son domaine d= n’est pas aligné sur votre domaine From. Une signature valide de d=vendor.example n’est pas un pass DKIM aligné pour From: news@example.com. DMARC réussit tout de même s’il existe un autre pass SPF ou DKIM aligné. Microsoft cite exactement ce symptôme dans son dépannage DKIM, et la réponse 4.7.32 de Gmail indique que l’en-tête From « n’est aligné ni sur le domaine organisationnel SPF authentifié ni sur le domaine organisationnel DKIM ».

En alignement relaxed, la correction est une signature dont le d= partage votre domaine organisationnel, comme d=example.com ou d=mail.example.com. Le domaine From exact n’est pas nécessaire. L’alignement est traité dans Alignement des identifiants pour SPF et DKIM, et la variante de ce problème avec des tiers dans Les e-mails de services tiers échouent à l’alignement.

Il y a aussi une particularité propre à Gmail. Gmail ne vérifie que les cinq premières signatures listées dans Authentication-Results. Si votre signature alignée n’en fait pas partie, le message échoue à DKIM, et cela « peut aussi faire échouer le message à DMARC ».

Diagnostiquer un échec DKIM, dans l’ordre

  1. Lisez Authentication-Results sur une copie reçue. Notez le résultat dkim=, le texte de la raison, header.d et header.s.
  2. « Body hash did not verify » → cherchez des passerelles, outils de pied de page, outils de réécriture pour le suivi ou listes sur le parcours (cause 1).
  3. « No key », permerror ou une erreur de syntaxe de clé → interrogez le sélecteur dans le DNS et comparez-le à la valeur fournie par votre fournisseur (cause 2).
  4. temperror → réessayez plus tard, puis vérifiez votre hébergeur DNS et vos TTL (cause 2).
  5. dkim=pass mais pas de pass DMARC → comparez header.d au domaine From (section précédente).
  6. Vérifiez l’ampleur. Vos rapports agrégés DMARC indiquent le domaine DKIM, le sélecteur et le résultat par source. Si une source échoue et que les autres réussissent, le problème vient de la configuration ou du parcours de cet expéditeur, pas de « DKIM pour tout le domaine » (Un rapport agrégé DMARC expliqué champ par champ).

Les erreurs à éviter

  • Supposer qu’un échec DKIM signifie que l’enregistrement DNS est erroné. Un corps modifié est une cause fréquente, et aucune modification DNS ne la corrige.
  • Supposer qu’un échec signifie qu’un attaquant a altéré l’e-mail. Une passerelle ou une liste légitime peut aussi modifier le contenu signé.
  • Régénérer les clés pour corriger un échec du hachage du corps. Cela ne change rien.
  • Publier la clé sans jamais activer la signature. Google a une étape Commencer l’authentification ; Microsoft 365 a son propre paramètre d’activation (Problèmes de configuration avec Microsoft 365 ou Google Workspace).
  • Utiliser l= pour que les pieds de page ne cassent pas la signature.

Compte DMARC gratuit

Des rapports DMARC bruts à un tableau de bord lisible

Faites pointer votre adresse rua vers notre plateforme et consultez les résultats par expéditeur et par source plutôt que dans des fichiers XML.

  • Résultats regroupés par source d’envoi
  • Résultats SPF, DKIM et d’alignement par expéditeur
  • Les rapports XML d’origine restent disponibles au téléchargement

Créer un compte DMARC gratuitParler à un expert

FAQ

Pourquoi mon DKIM échoue-t-il ?

Commencez par le texte de la raison dans Authentication-Results. « Body hash did not verify » signifie que quelque chose a modifié le corps après la signature. « No key » ou une erreur de syntaxe signifie que l’enregistrement est manquant, mal placé ou tronqué. temperror signifie que le DNS n’a pas répondu.

Que signifie « body hash did not verify » ?

Le corps a changé après la signature, généralement à cause d’un pied de page, d’une passerelle ou d’une liste. Corrigez le système qui modifie le message, pas le DNS.

Pourquoi DKIM n’échoue-t-il que de temps en temps ?

Cherchez des erreurs DNS temporaires, des e-mails qui empruntent des parcours différents (certains via une passerelle ou une liste), ou un renouvellement qui a supprimé une clé trop tôt.

Puis-je faire survivre DKIM aux listes de diffusion ?

Pas de façon fiable côté envoi. Voir DKIM, listes de diffusion et services de transfert.