Varför DKIM-signaturer misslyckas
DKIM-signaturer underkänns oftast av ett av två skäl: meddelandet ändrades efter att det signerades, eller mottagaren hittade ingen användbar publik nyckel på den selektor som anges i signaturen. Tillfälliga DNS-problem och signeringsmisstag står för resten. Var och en kräver en egen lösning. En sidfot som läggs till efter signeringen botas inte genom att du publicerar om din DNS-post, och en post som saknas botas inte genom att du ändrar din e-postgateway. Och om DKIM godkändes men DMARC ändå inte gjorde det är det inte alls ett DKIM-fel. Det handlar om anpassning (alignment).
Vad ”DKIM fail” betyder
När en mottagare kontrollerar en signatur returnerar den antingen ett permanent fel (PERMFAIL) eller ett tillfälligt (TEMPFAIL), med en kort orsak inom parentes, till exempel ”body hash did not verify” eller ”no key for signature”. Mottagarna registrerar oftast utfallet i huvudet Authentication-Results som fail, neutral, policy, temperror eller permerror. En typisk rad:
Authentication-Results: mx.receiver.example;
dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026
header.d är den signerande domänen och header.s är selektorn. De två, plus orsakstexten, talar om vilken familj av problem du har att göra med.
Ett DKIM-fel får inte i sig mottagaren att avvisa meddelandet. En underkänd signatur tvingar inte fram ett avvisande. Vad som händer sedan beror på mottagarens filtrering och din DMARC-policy. För massavsändare till Gmail har ett DKIM-fel dock en direkt kostnad. Gmail listar de här svaren:
- 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 bredare leverantörsreglerna finns i Avsändarkrav från Google, Yahoo och Microsoft.
Vanliga orsaker till DKIM-fel
1. Meddelandet ändrades efter signeringen (”body hash did not verify”)
Om DKIM ”fungerade i går”, börja här.
”Body hash did not verify” betyder att brödtexten ändrades efter att den signerades. Google säger det rakt ut: om texten bredvid DKIM-posten är ”body hash did not verify” har meddelandet ändrats under vägen. Typiska bovar:
- En utgående gateway eller ett verktyg för ansvarsfriskrivningar som lägger till en sidfot efter att din e-postplattform har signerat meddelandet. Google varnar för just detta.
- Verktyg för länkomskrivning eller spårning som redigerar brödtexten efter signeringen.
- E-postlistor som lägger till sidfötter (DKIM, e-postlistor och vidarebefordran).
Om du ser det här felet i Microsoft 365 betyder det samma sak: något på vägen redigerade brödtexten efter signeringen.
”Signature did not verify” med matchande hash för brödtexten kan betyda att ett signerat huvud har ändrats. En lista som lägger till [tag] i ämnesraden är det klassiska fallet.
Ändrad kodning räknas också. Att konvertera 8-bitarsinnehåll till 7 bitar under vägen bryter DKIM-signaturer, så signerare bör koda meddelandet före signeringen, på det sätt som det förväntas tas emot.
Kanoniseringen spelar roll. simple går sönder vid nästan varje ändring; relaxed tolererar blanksteg och omradbrutna huvuden men inte ändringar i innehållet. Microsoft 365 använder relaxed som standard för både huvud och brödtext.
Lösningen: signera efter det sista system som ändrar meddelandet, eller hindra det systemet från att röra signerat innehåll. Samma råd gäller e-postlistor: signera efter att meddelandet har förberetts för distribution. Ändra inte DNS, och generera inte nya nycklar. Inget av det hjälper en brödtext som har skrivits om.
2. Mottagaren kan inte hitta eller läsa nyckeln
Mottagaren slår upp exakt <s=>._domainkey.<d=>. Om uppslaget misslyckas beror resultatet på varför:
- No key for signature (PERMFAIL). Inget är publicerat på det namnet. Posten publicerades aldrig, den lades in under fel värdnamn (Microsoft lyfter fram den dubblerade domänen, till exempel
selector1._domainkey.example.com.example.com), den ligger i fel DNS-zon, selektorn är felstavad eller så togs nyckeln bort för tidigt under en rotation (Så roterar du en DKIM-nyckel). Om avsändaren signerar med en selektor eller end=-domän som du aldrig har publicerat hamnar du också här. Den fullständiga diagnosen av ”ingen post” finns i DKIM-signaturen hittades inte. - Key unavailable (TEMPFAIL). DNS svarade inte. Det är det enda fallet där ett tillfälligt SMTP-svar med 4xx är lämpligt. För Microsoft 365 hänger sporadiska
dkim=temperrorofta ihop med mycket låga TTL-värden på DKIM:s CNAME-poster; en TTL på minst 3600 sekunder rekommenderas. - Key syntax error (PERMFAIL). Posten är felaktigt utformad. Det klassiska fallet är en nyckel på 2048 bitar som har kapats vid 255 tecken, eller uppdelade strängar som lagrats i fel ordning (DKIM-nycklar på 1024 eller 2048 bitar).
- Key revoked (PERMFAIL). Posten har ett tomt
p=. Det är en avsiktlig pensionering, så e-post som fortfarande signeras med den nyckeln underkänns. - Fel posttyp. En TXT-post där leverantören förväntar sig en CNAME-post, eller en CNAME-post som proxas via Cloudflare i stället för att vara inställd på DNS only.
- För tidigt. Det kan ta upp till 48 timmar innan en ny nyckel börjar fungera.
Postformat och fällan med den dubblerade domänen beskrivs i DKIM-selektorer och DNS-poster.
3. Själva signaturen är felkonfigurerad
Det här är konfigurationsproblem hos signeraren, och de är permanenta fel:
- En obligatorisk tagg saknas (
v,a,b,bh,d,h,s). - From-huvudet finns inte i
h=(”From field not signed”). i=-domänen är inted=-domänen eller en underdomän till den (”domain mismatch”).- Signaturen har gått ut (
x=ligger i det förflutna). Verifierare kan underkänna den, vilket mest påverkar kraftigt försenad eller återuppspelad e-post. - Algoritmen är
rsa-sha1, som permanent underkänns vid utvärdering, eller så är RSA-nyckeln kortare än 1024 bitar.
Två närliggande inställningar förtjänar också en kontroll:
- Taggen
l=för brödtextens längd lämnar innehåll efter gränsen overifierat. Det kan missbrukas, och bedömare kan bortse från signaturer som använder taggen. Använd intel=, eftersom meddelanden som använder den är sårbara för missbruk. - En nyckelpost med
t=y(test) är inget fel, men mottagarna måste behandla e-posten som osignerad, så du får ingen nytta av DKIM.
Om du skickar marknadsföringsutskick med avregistrering med ett klick, kontrollera även att h= innehåller listhuvudena. Meddelandet måste ha en giltig DKIM-signatur som täcker åtminstone List-Unsubscribe och List-Unsubscribe-Post.
4. Det gick sönder efter att det lämnat dig
Vanlig vidarebefordran lämnar oftast DKIM intakt. E-postlistor som märker ämnesrader, lägger till sidfötter eller skriver om MIME-delar bryter det oftast. Vidarebefordrade meddelanden kan underkännas i DKIM även när din konfiguration är korrekt. Du kan inte helt lösa det här från avsändarsidan. Se DKIM, e-postlistor och vidarebefordran.
När DKIM godkändes för fel domän
Ibland säger rapporten dkim=pass och DMARC godkänns ändå inte. Det är inget DKIM-fel. Signaturen verifierades, men dess d=-domän är inte anpassad till din From-domän. En giltig signatur från d=vendor.example är inget anpassat DKIM-pass för From: news@example.com. DMARC godkänns ändå om det finns ett annat anpassat godkännande via SPF eller DKIM. Microsoft listar just det här symptomet i sin felsökning av DKIM, och Gmails svar 4.7.32 säger att From-huvudet ”isn’t aligned with either the authenticated SPF or DKIM organizational domain”.
Med relaxed anpassning är lösningen en signatur vars d= har samma organisationsdomän som du, till exempel d=example.com eller d=mail.example.com. Du behöver inte den exakta From-domänen. Anpassning beskrivs i Anpassning av identifierare för SPF och DKIM, och tredjepartsvarianten av problemet i E-post från tredje part klarar inte anpassningen.
Det finns också en Gmail-specifik detalj. Gmail kontrollerar bara de fem första signaturerna som listas i Authentication-Results. Om din anpassade signatur inte finns bland dem underkänns meddelandet i DKIM, och det kan också leda till att meddelandet underkänns i DMARC.
Så diagnostiserar du ett DKIM-fel, i ordning
- Läs
Authentication-Resultsi en mottagen kopia. Noteradkim=-resultatet, orsakstexten,header.dochheader.s. - ”Body hash did not verify” → leta efter gatewayer, sidfotsverktyg, spårningsverktyg som skriver om länkar eller listor på vägen (orsak 1).
- ”No key”, permerror eller ett syntaxfel i nyckeln → slå upp selektorn i DNS och jämför med värdet som din leverantör gav dig (orsak 2).
- temperror → försök igen senare, och kontrollera sedan din DNS-värd och dina TTL-värden (orsak 2).
dkim=passmen inget DMARC-pass → jämförheader.dmed From-domänen (föregående avsnitt).- Kontrollera omfattningen. Dina aggregerade DMARC-rapporter visar DKIM-domän, selektor och resultat per källa. Om en källa underkänns och resten godkänns ligger problemet i den avsändarens konfiguration eller väg, inte i ”DKIM för hela domänen” (En DMARC-aggregatrapport genomgången fält för fält).
Misstag som är värda att undvika
- Att utgå från att ett DKIM-fel betyder att DNS-posten är fel. En ändrad brödtext är en vanlig orsak, och ingen DNS-ändring löser det.
- Att utgå från att ett fel betyder att en angripare har manipulerat e-posten. En legitim gateway eller lista kan också ändra signerat innehåll.
- Att generera nya nycklar för att lösa ett fel med brödtextens hash. Det ändrar ingenting.
- Att publicera nyckeln och aldrig slå på signeringen. Google har steget Starta autentisering; Microsoft 365 har en egen inställning för att aktivera (Konfigurationsproblem med Microsoft 365 eller Google Workspace).
- Att använda
l=för att sidfötter inte ska bryta signaturen.
Gratis DMARC-konto
Från råa DMARC-rapporter till en lättläst översikt
Peka din rua-adress mot vår plattform och läs resultaten per avsändare och källa i stället för att öppna XML-filer.
- Resultat grupperade per avsändarkälla
- SPF-, DKIM- och anpassningsresultat per avsändare
- De ursprungliga XML-rapporterna finns kvar att ladda ner
Vanliga frågor
Varför underkänns min DKIM?
Börja med orsakstexten i Authentication-Results. ”Body hash did not verify” betyder att något ändrade brödtexten efter signeringen. ”No key” eller ett syntaxfel betyder att posten saknas, ligger fel eller är avkortad. temperror betyder att DNS inte svarade.
Vad betyder ”body hash did not verify”?
Brödtexten ändrades efter signeringen, oftast på grund av en sidfot, en gateway eller en lista. Åtgärda det system som ändrar meddelandet, inte DNS.
Varför underkänns DKIM bara ibland?
Leta efter tillfälliga DNS-fel, e-post som tar olika vägar (en del via en gateway eller lista) eller en rotation som tog bort en nyckel för tidigt.
Kan jag få DKIM att klara e-postlistor?
Inte på ett tillförlitligt sätt från avsändarsidan. Se DKIM, e-postlistor och vidarebefordran.