Overslaan naar inhoud
  • Er zijn geen suggesties want het zoekveld is leeg.

Waarom DKIM-handtekeningen mislukken

DKIM-handtekeningen mislukken meestal om een van twee redenen: het bericht is na het ondertekenen gewijzigd, of de ontvanger kon op de selector die in de handtekening wordt genoemd geen bruikbare openbare sleutel vinden. Tijdelijke DNS-problemen en fouten bij het ondertekenen verklaren de rest. Elk vraagt om een andere oplossing. Een voettekst die na het ondertekenen is toegevoegd, verhelpt u niet door uw DNS-record opnieuw te publiceren, en een ontbrekend record verhelpt u niet door uw mailgateway te wijzigen. En als DKIM slaagde maar DMARC toch niet, is dat helemaal geen DKIM-fout. Het is een kwestie van uitlijning (alignment).

Wat “DKIM fail” betekent

Als een ontvanger een handtekening controleert, geeft hij een permanente mislukking (PERMFAIL) of een tijdelijke (TEMPFAIL), met een korte reden tussen haakjes, zoals “body hash did not verify” of “no key for signature”. Ontvangers leggen de uitkomst meestal vast in de header Authentication-Results als fail, neutral, policy, temperror of permerror. Een typische regel:

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

header.d is het ondertekenende domein en header.s de selector. Die twee, plus de tekst van de reden, vertellen u met welk soort probleem u te maken hebt.

Een DKIM-mislukking laat de ontvanger het bericht op zichzelf niet weigeren. Een mislukte handtekening dwingt geen weigering af. Wat er daarna gebeurt, hangt af van de filtering van de ontvanger en van uw DMARC-beleid. Voor bulkafzenders naar Gmail heeft een DKIM-mislukking echter directe gevolgen. Gmail noemt deze antwoorden:

  • 4.7.30: “Your email has been rate limited because DKIM authentication didn’t pass for this message. Gmail requires all email bulk senders to authenticate their email with DKIM.”
  • 5.7.30: “This message was blocked because it didn’t pass DKIM authentication. Gmail requires bulk email senders to authenticate their email with DKIM.”

De bredere regels van providers staan in Afzendereisen van Google, Yahoo en Microsoft.

Veelvoorkomende redenen waarom DKIM mislukt

1. Het bericht is na het ondertekenen gewijzigd (“body hash did not verify”)

Als DKIM “gisteren nog werkte”, begin dan hier.

“Body hash did not verify” betekent dat de body na het ondertekenen is gewijzigd. Google zegt het duidelijk: als de tekst naast de DKIM-vermelding “body hash did not verify” is, “is het bericht onderweg gewijzigd”. Typische boosdoeners:

  • Een uitgaande gateway of disclaimertool die een voettekst toevoegt nadat uw mailplatform het bericht heeft ondertekend. Google waarschuwt precies hiervoor.
  • Tools voor het herschrijven of volgen van links die de body na het ondertekenen bewerken.
  • Mailinglijsten die voetteksten toevoegen (DKIM, mailinglijsten en doorstuurdiensten).

Als u deze fout in Microsoft 365 ziet, betekent die hetzelfde: iets onderweg heeft de body na het ondertekenen bewerkt.

“Signature did not verify” met een overeenkomende body-hash kan betekenen dat een ondertekende header is gewijzigd. Een lijst die [tag] aan het onderwerp toevoegt, is het klassieke geval.

Wijzigingen in de codering tellen ook mee. Het onderweg omzetten van 8-bits inhoud naar 7-bits breekt DKIM-handtekeningen, dus ondertekenaars zouden het bericht vóór het ondertekenen zo moeten coderen als het naar verwachting wordt ontvangen.

Canonicalisatie doet ertoe. simple breekt bij bijna elke wijziging; relaxed verdraagt witruimte en opnieuw afgebroken headers, maar geen inhoudelijke bewerkingen. Microsoft 365 gebruikt standaard relaxed voor zowel header als body.

De oplossing: onderteken na het laatste systeem dat het bericht wijzigt, of voorkom dat dat systeem ondertekende inhoud aanraakt. Hetzelfde advies geldt voor mailinglijsten: onderteken nadat het bericht is voorbereid voor verspreiding. Wijzig de DNS niet en genereer geen nieuwe sleutels. Geen van beide helpt bij een body die is herschreven.

2. De ontvanger kan de sleutel niet vinden of lezen

De ontvanger zoekt precies <s=>._domainkey.<d=> op. Als die lookup mislukt, hangt het resultaat af van de reden:

  • Geen sleutel voor de handtekening (PERMFAIL). Er is niets gepubliceerd op die naam. Het is nooit gepubliceerd, het staat onder de verkeerde hostnaam (Microsoft wijst op het dubbele domein, zoals selector1._domainkey.example.com.example.com), het staat in de verkeerde DNS-zone, de selector is verkeerd gespeld, of de sleutel is tijdens een rotatie te vroeg verwijderd (Een DKIM-sleutel roteren). Als de verzender ondertekent met een selector of d=-domein dat u nooit hebt gepubliceerd, komt u hier ook uit. De volledige diagnose bij “geen record” staat in DKIM-handtekening niet gevonden.
  • Sleutel niet beschikbaar (TEMPFAIL). De DNS gaf geen antwoord. Dit is het enige geval waarin een tijdelijk SMTP-antwoord 4xx gepast is. Bij Microsoft 365 hangt af en toe optredende dkim=temperror vaak samen met zeer lage TTL’s op de DKIM-CNAME’s; een TTL van minstens 3600 seconden wordt aanbevolen.
  • Syntaxisfout in de sleutel (PERMFAIL). Het record is misvormd. Het klassieke geval is een sleutel van 2048 bits die na 255 tekens is afgekapt, of gesplitste strings die in de verkeerde volgorde zijn opgeslagen (DKIM-sleutels van 1024 of 2048 bit).
  • Sleutel ingetrokken (PERMFAIL). Het record heeft een lege p=. Dat is een bewuste buitengebruikstelling, dus e-mail die nog met die sleutel is ondertekend, mislukt.
  • Verkeerd recordtype. Een TXT waar de provider een CNAME verwacht, of een CNAME die via Cloudflare wordt geproxied in plaats van op DNS only te staan.
  • Te vroeg. Het kan tot 48 uur duren voordat een nieuwe sleutel werkt.

Recordformaten en de valkuil van het dubbele domein staan in DKIM-selectors en DNS-records.

3. De handtekening zelf is verkeerd ingesteld

Dit zijn configuratieproblemen bij de ondertekenaar, en het zijn permanente mislukkingen:

  • Er ontbreekt een verplichte tag (v, a, b, bh, d, h, s).
  • De From-header staat niet in h= (“From field not signed”).
  • Het i=-domein is niet het d=-domein of een subdomein daarvan (“domain mismatch”).
  • De handtekening is verlopen (x= ligt in het verleden). Verifiërende systemen kunnen haar laten mislukken, wat vooral sterk vertraagde of opnieuw afgespeelde e-mail treft.
  • Het algoritme is rsa-sha1, dat bij de beoordeling permanent mislukt, of de RSA-sleutel is korter dan 1024 bits.

Twee verwante instellingen verdienen ook een controle:

  • De tag l= voor de lengte van de body laat inhoud voorbij de limiet ongeverifieerd. Dat kan worden misbruikt, en beoordelaars negeren mogelijk handtekeningen die de tag gebruiken. Gebruik l= niet, omdat berichten die de tag gebruiken kwetsbaar zijn voor misbruik.
  • Een sleutelrecord met t=y (testen) is geen mislukking, maar ontvangers moeten de e-mail behandelen als niet-ondertekende e-mail, dus u hebt geen voordeel van DKIM.

Als u marketingmail verstuurt met afmelden met één klik, controleer dan ook of h= de lijstheaders bevat. Het bericht moet een geldige DKIM-handtekening hebben die minstens List-Unsubscribe en List-Unsubscribe-Post dekt.

4. Het mislukte nadat het bij u was vertrokken

Gewoon doorsturen laat DKIM meestal intact. Mailinglijsten die onderwerpen taggen, voetteksten toevoegen of MIME-delen herschrijven, breken het meestal. Doorgestuurde berichten kunnen voor DKIM mislukken, zelfs als uw configuratie correct is. Vanaf de verzendende kant kunt u dit niet volledig oplossen. Zie DKIM, mailinglijsten en doorstuurdiensten.

Als DKIM slaagde voor het verkeerde domein

Soms zegt het rapport dkim=pass en slaagt DMARC toch niet. Dat is geen DKIM-mislukking. De handtekening is geverifieerd, maar het d=-domein ervan is niet uitgelijnd met uw From-domein. Een geldige handtekening van d=vendor.example is geen uitgelijnde DKIM-pass voor From: news@example.com. DMARC slaagt nog steeds als er een andere uitgelijnde SPF- of DKIM-pass is. Microsoft noemt precies dit symptoom in zijn DKIM-probleemoplossing, en het antwoord 4.7.32 van Gmail zegt dat de From-header “isn’t aligned with either the authenticated SPF or DKIM organizational domain.”

Bij relaxed uitlijning is de oplossing een handtekening waarvan het d=-domein uw organisatiedomein deelt, zoals d=example.com of d=mail.example.com. U hebt niet het exacte From-domein nodig. Uitlijning wordt behandeld in Uitlijning van identifiers voor SPF en DKIM, en de variant van dit probleem bij derden in E-mail van derden slaagt niet voor uitlijning.

Er is ook een eigenaardigheid die specifiek voor Gmail geldt. Gmail controleert alleen de eerste vijf handtekeningen die in Authentication-Results worden vermeld. Als uw uitgelijnde handtekening daar niet bij zit, mislukt het bericht voor DKIM, en dat “kan er ook toe leiden dat het bericht niet slaagt voor DMARC”.

Zo stelt u de diagnose bij een DKIM-mislukking, op volgorde

  1. Lees Authentication-Results in een ontvangen exemplaar. Noteer het dkim=-resultaat, de tekst van de reden, header.d en header.s.
  2. “Body hash did not verify” → zoek naar gateways, voettekst-tools, linkherschrijvers of lijsten onderweg (reden 1).
  3. “No key”, permerror of een syntaxisfout in de sleutel → zoek de selector op in de DNS en vergelijk die met de waarde die uw provider u gaf (reden 2).
  4. temperror → probeer het later opnieuw, en controleer daarna uw DNS-host en TTL’s (reden 2).
  5. dkim=pass maar geen DMARC-pass → vergelijk header.d met het From-domein (vorige sectie).
  6. Controleer de omvang. Uw geaggregeerde DMARC-rapporten tonen per bron het DKIM-domein, de selector en het resultaat. Als één bron mislukt en de rest slaagt, zit het probleem in de configuratie of het pad van die verzender, niet in “DKIM voor het hele domein” (Een geaggregeerd DMARC-rapport veld voor veld uitgelegd).

Fouten die u beter kunt vermijden

  • Aannemen dat een DKIM-mislukking betekent dat het DNS-record fout is. Een gewijzigde body is een veelvoorkomende oorzaak, en geen enkele DNS-wijziging lost die op.
  • Aannemen dat een mislukking betekent dat een aanvaller met de e-mail heeft geknoeid. Een legitieme gateway of lijst kan ook ondertekende inhoud wijzigen.
  • Nieuwe sleutels genereren om een mislukking van de body-hash op te lossen. Dat verandert niets.
  • De sleutel publiceren en het ondertekenen nooit inschakelen. Google heeft een stap Start authentication; Microsoft 365 heeft een eigen instelling om het in te schakelen (Configuratieproblemen met Microsoft 365 of Google Workspace).
  • l= gebruiken zodat voetteksten de handtekening niet breken.

Gratis DMARC-account

Van ruwe DMARC-rapporten naar een overzichtelijk dashboard

Laat uw rua-adres naar ons platform verwijzen en lees de resultaten per afzender en bron in plaats van XML-bestanden te openen.

  • Resultaten gegroepeerd per verzendbron
  • SPF-, DKIM- en uitlijningsresultaten per afzender
  • De originele XML-rapporten blijven beschikbaar om te downloaden

Maak een gratis DMARC-account aanSpreek met een expert

Veelgestelde vragen

Waarom mislukt mijn DKIM?

Begin met de tekst van de reden in Authentication-Results. “Body hash did not verify” betekent dat iets de body na het ondertekenen heeft gewijzigd. “No key” of een syntaxisfout betekent dat het record ontbreekt, op de verkeerde plek staat of is afgekapt. temperror betekent dat de DNS geen antwoord gaf.

Wat betekent “body hash did not verify”?

De body is na het ondertekenen gewijzigd, meestal door een voettekst, gateway of lijst. Pak het systeem aan dat het bericht wijzigt, niet de DNS.

Waarom mislukt DKIM maar af en toe?

Zoek naar tijdelijke DNS-fouten, e-mail die verschillende paden volgt (sommige via een gateway of lijst), of een rotatie waarbij een sleutel te vroeg is verwijderd.

Kan ik DKIM mailinglijsten laten overleven?

Niet betrouwbaar vanaf de verzendende kant. Zie DKIM, mailinglijsten en doorstuurdiensten.