Warum DKIM-Signaturen fehlschlagen
DKIM-Signaturen schlagen meist aus einem von zwei Gründen fehl: Die Nachricht wurde nach dem Signieren verändert, oder der Empfänger konnte unter dem in der Signatur genannten Selektor keinen brauchbaren öffentlichen Schlüssel finden. Den Rest verursachen vorübergehende DNS-Probleme und Fehler beim Signieren. Jede Ursache braucht eine andere Lösung. Eine nach dem Signieren angefügte Fußzeile lässt sich nicht durch erneutes Veröffentlichen Ihres DNS-Eintrags beheben, und ein fehlender Eintrag nicht durch eine Änderung an Ihrem Mail-Gateway. Und wenn DKIM bestanden hat, DMARC aber trotzdem nicht, ist das gar kein DKIM-Fehler, sondern eine Frage der Ausrichtung (Alignment).
Was „DKIM fail“ bedeutet
Wenn ein Empfänger eine Signatur prüft, gibt er entweder einen dauerhaften (PERMFAIL) oder einen vorübergehenden Fehler (TEMPFAIL) zurück, mit einer kurzen Begründung in Klammern, etwa „body hash did not verify“ oder „no key for signature“. Empfänger halten das Ergebnis meist im Header Authentication-Results als fail, neutral, policy, temperror oder permerror fest. Eine typische Zeile:
Authentication-Results: mx.receiver.example;
dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026
header.d ist die signierende Domain, header.s der Selektor. Diese beiden Werte und der Begründungstext zeigen Ihnen, mit welcher Art von Problem Sie es zu tun haben.
Ein DKIM-Fehler allein führt nicht dazu, dass der Empfänger die Nachricht ablehnt. Eine fehlgeschlagene Signatur erzwingt keine Ablehnung. Was danach passiert, hängt von der Filterung des Empfängers und Ihrer DMARC-Richtlinie ab. Für Massenversender an Gmail hat ein DKIM-Fehler allerdings direkte Folgen. Gmail führt diese Antworten auf:
- 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.“
Die weiteren Regeln der Anbieter finden Sie in Absenderanforderungen von Google, Yahoo und Microsoft.
Häufige Gründe für DKIM-Fehler
1. Die Nachricht wurde nach dem Signieren verändert („body hash did not verify“)
Wenn DKIM „gestern noch funktioniert hat“, beginnen Sie hier.
„Body hash did not verify“ bedeutet, dass der Nachrichtentext nach dem Signieren verändert wurde. Google formuliert es deutlich: Lautet der Text neben dem DKIM-Eintrag „body hash did not verify“, dann „wurde die Nachricht während der Übertragung verändert“. Typische Ursachen:
- Ein ausgehendes Gateway oder Disclaimer-Tool, das eine Fußzeile anfügt, nachdem Ihre Mailplattform die Nachricht signiert hat. Genau davor warnt Google.
- Tools zum Umschreiben von Links oder zum Tracking, die den Text nach dem Signieren bearbeiten.
- Mailinglisten, die Fußzeilen anhängen (DKIM bei Mailinglisten und Weiterleitungen).
Sehen Sie diesen Fehler in Microsoft 365, bedeutet er dasselbe: Etwas auf dem Weg hat den Text nach dem Signieren bearbeitet.
„Signature did not verify“ bei passendem Body-Hash kann bedeuten, dass sich ein signierter Header geändert hat. Der klassische Fall ist eine Liste, die [tag] in den Betreff einfügt.
Änderungen der Codierung zählen ebenfalls. Wird 8-Bit-Inhalt unterwegs in 7 Bit umgewandelt, bricht das DKIM-Signaturen; signierende Systeme sollten die Nachricht daher vor dem Signieren so codieren, wie sie voraussichtlich empfangen wird.
Die Kanonisierung spielt eine Rolle. simple bricht bei fast jeder Änderung; relaxed toleriert Leerzeichen und neu umbrochene Header, aber keine inhaltlichen Änderungen. Microsoft 365 verwendet standardmäßig relaxed für Header und Body.
Die Lösung: Signieren Sie nach dem letzten System, das die Nachricht verändert, oder verhindern Sie, dass dieses System signierte Inhalte anfasst. Für Mailinglisten gilt dasselbe: signieren, nachdem die Nachricht für den Versand vorbereitet wurde. Ändern Sie nichts am DNS und erzeugen Sie keine neuen Schlüssel. Beides hilft nicht, wenn der Text umgeschrieben wurde.
2. Der Empfänger kann den Schlüssel nicht finden oder lesen
Der Empfänger fragt genau <s=>._domainkey.<d=> ab. Schlägt diese Abfrage fehl, hängt das Ergebnis vom Grund ab:
- No key for signature (PERMFAIL). Unter diesem Namen ist nichts veröffentlicht. Der Eintrag wurde nie veröffentlicht, er wurde unter dem falschen Hostnamen angelegt (Microsoft weist auf die doppelte Domain hin, etwa
selector1._domainkey.example.com.example.com), er liegt in der falschen DNS-Zone, der Selektor ist falsch geschrieben, oder der Schlüssel wurde bei einer Rotation zu früh gelöscht (So rotieren Sie einen DKIM-Schlüssel). Signiert der Absender mit einem Selektor oder einerd=-Domain, die Sie nie veröffentlicht haben, landen Sie ebenfalls hier. Die vollständige Diagnose für „kein Eintrag“ finden Sie in DKIM-Signatur nicht gefunden. - Key unavailable (TEMPFAIL). Das DNS hat nicht geantwortet. Nur in diesem Fall ist eine vorübergehende SMTP-Antwort 4xx angemessen. Bei Microsoft 365 hängt ein sporadisches
dkim=temperroroft mit sehr niedrigen TTLs der DKIM-CNAMEs zusammen; empfohlen wird eine TTL von mindestens 3600 Sekunden. - Key syntax error (PERMFAIL). Der Eintrag ist fehlerhaft. Der klassische Fall ist ein 2048-Bit-Schlüssel, der nach 255 Zeichen abgeschnitten wurde, oder aufgeteilte Strings in falscher Reihenfolge (DKIM-Schlüssel mit 1024 Bit vs. 2048 Bit).
- Key revoked (PERMFAIL). Der Eintrag hat ein leeres
p=. Das ist eine bewusste Stilllegung, daher scheitern E-Mails, die noch mit diesem Schlüssel signiert sind. - Falscher Eintragstyp. Ein TXT, wo der Anbieter einen CNAME erwartet, oder ein CNAME, der über Cloudflare geproxyt wird, statt auf DNS only gesetzt zu sein.
- Zu früh. Bei einem neuen Schlüssel kann es bis zu 48 Stunden dauern, bis er funktioniert.
Eintragsformate und die Falle mit der doppelten Domain beschreibt DKIM-Selektoren und DNS-Einträge.
3. Die Signatur selbst ist falsch eingerichtet
Das sind Konfigurationsprobleme beim signierenden System, und sie führen zu dauerhaften Fehlern:
- Ein Pflicht-Tag fehlt (
v,a,b,bh,d,h,s). - Der From-Header ist nicht in
h=enthalten („From field not signed“). - Die
i=-Domain ist weder died=-Domain noch eine ihrer Subdomains („domain mismatch“). - Die Signatur ist abgelaufen (
x=liegt in der Vergangenheit). Prüfende Systeme können sie als fehlgeschlagen werten; das betrifft vor allem stark verzögerte oder erneut abgespielte E-Mails. - Der Algorithmus ist
rsa-sha1, der bei der Prüfung grundsätzlich als fehlgeschlagen gilt, oder der RSA-Schlüssel ist kürzer als 1024 Bit.
Zwei verwandte Einstellungen sollten Sie ebenfalls prüfen:
- Das Tag
l=für die Body-Länge lässt Inhalte jenseits der Grenze ungeprüft. Das lässt sich missbrauchen, und prüfende Systeme ignorieren Signaturen mit diesem Tag möglicherweise. Verwenden Siel=nicht, denn Nachrichten damit sind anfällig für Missbrauch. - Ein Schlüsseleintrag mit
t=y(Testmodus) ist kein Fehler, aber Empfänger müssen die E-Mail wie unsignierte E-Mail behandeln, Sie haben also keinen Nutzen von DKIM.
Wenn Sie Marketing-E-Mails mit Abmeldung per Klick versenden, prüfen Sie in h= auch die Listen-Header. Die Nachricht muss eine gültige DKIM-Signatur haben, die mindestens List-Unsubscribe und List-Unsubscribe-Post abdeckt.
4. Der Fehler entstand, nachdem die E-Mail Sie verlassen hat
Einfache Weiterleitung lässt DKIM meist intakt. Mailinglisten, die Betreffzeilen markieren, Fußzeilen anfügen oder MIME-Teile umschreiben, brechen es meist. Weitergeleitete Nachrichten können an DKIM scheitern, selbst wenn Ihre Einrichtung korrekt ist. Von der Absenderseite aus lässt sich das nicht vollständig beheben. Siehe DKIM bei Mailinglisten und Weiterleitungen.
Wenn DKIM für die falsche Domain bestanden hat
Manchmal meldet der Bericht dkim=pass, und DMARC besteht trotzdem nicht. Das ist kein DKIM-Fehler. Die Signatur wurde verifiziert, aber ihre d=-Domain ist nicht an Ihrer From-Domain ausgerichtet. Eine gültige Signatur von d=vendor.example ist kein DKIM-Pass mit Ausrichtung für From: news@example.com. DMARC besteht trotzdem, wenn ein anderer SPF- oder DKIM-Pass mit Ausrichtung vorliegt. Microsoft nennt genau dieses Symptom in seiner DKIM-Fehlerbehebung, und die Gmail-Antwort 4.7.32 besagt, dass der From-Header „isn't aligned with either the authenticated SPF or DKIM organizational domain.“
Bei Relaxed-Ausrichtung besteht die Lösung in einer Signatur, deren d= Ihre Organisationsdomain teilt, etwa d=example.com oder d=mail.example.com. Die exakte From-Domain ist nicht nötig. Ausrichtung behandelt Identifier-Ausrichtung für SPF und DKIM, die Drittanbieter-Variante dieses Problems Ausrichtung schlägt bei E-Mails von Drittanbietern fehl.
Bei Gmail gibt es noch eine Besonderheit. Gmail prüft nur die ersten fünf in Authentication-Results aufgeführten Signaturen. Ist Ihre Signatur mit Ausrichtung nicht darunter, scheitert die Nachricht an DKIM, und das „kann auch dazu führen, dass die Nachricht an DMARC scheitert“.
So diagnostizieren Sie einen DKIM-Fehler, Schritt für Schritt
- Lesen Sie
Authentication-Resultsin einer empfangenen Kopie. Notieren Sie das Ergebnisdkim=, den Begründungstext,header.dundheader.s. - „Body hash did not verify“ → suchen Sie nach Gateways, Fußzeilen-Tools, Tracking-Umschreibern oder Listen auf dem Weg (Grund 1).
- „No key“, permerror oder ein Syntaxfehler im Schlüssel → fragen Sie den Selektor im DNS ab und vergleichen Sie ihn mit dem Wert, den Ihnen Ihr Anbieter gegeben hat (Grund 2).
- temperror → später erneut versuchen, dann Ihren DNS-Anbieter und die TTLs prüfen (Grund 2).
dkim=pass, aber kein DMARC-Pass → vergleichen Sieheader.dmit der From-Domain (vorheriger Abschnitt).- Prüfen Sie das Ausmaß. Ihre aggregierten DMARC-Berichte zeigen DKIM-Domain, Selektor und Ergebnis pro Quelle. Scheitert eine Quelle und die übrigen bestehen, liegt das Problem bei der Einrichtung oder dem Weg dieses Absenders, nicht bei „DKIM für die ganze Domain“ (Ein DMARC-Aggregatbericht, Feld für Feld erklärt).
Fehler, die Sie vermeiden sollten
- Annehmen, ein DKIM-Fehler bedeute einen falschen DNS-Eintrag. Ein veränderter Text ist eine häufige Ursache, und keine DNS-Änderung behebt ihn.
- Annehmen, ein Fehler bedeute, dass ein Angreifer die E-Mail manipuliert hat. Auch ein legitimes Gateway oder eine Liste kann signierte Inhalte verändern.
- Neue Schlüssel erzeugen, um einen Body-Hash-Fehler zu beheben. Das ändert nichts.
- Den Schlüssel veröffentlichen und das Signieren nie einschalten. Bei Google gibt es den Schritt Start authentication, Microsoft 365 hat eine eigene Einstellung zum Aktivieren (Einrichtungsprobleme bei Microsoft 365 oder Google Workspace).
l=verwenden, damit Fußzeilen die Signatur nicht brechen.
Kostenloses DMARC-Konto
Aus rohen DMARC-Berichten wird ein übersichtliches Dashboard
Tragen Sie unsere Plattform als rua-Adresse ein und lesen Sie die Ergebnisse nach Absender und Quelle, statt XML-Dateien zu öffnen.
- Ergebnisse nach Versandquelle gruppiert
- SPF-, DKIM- und Ausrichtungsergebnisse pro Absender
- Die originalen XML-Berichte bleiben zum Download verfügbar
Kostenloses DMARC-Konto erstellenMit einem Experten sprechen
FAQ
Warum schlägt mein DKIM fehl?
Beginnen Sie mit dem Begründungstext in Authentication-Results. „Body hash did not verify“ bedeutet, dass etwas den Text nach dem Signieren verändert hat. „No key“ oder ein Syntaxfehler bedeutet, dass der Eintrag fehlt, falsch platziert oder abgeschnitten ist. temperror bedeutet, dass das DNS nicht geantwortet hat.
Was bedeutet „body hash did not verify“?
Der Text wurde nach dem Signieren verändert, meist durch eine Fußzeile, ein Gateway oder eine Liste. Beheben Sie das am System, das die Nachricht verändert, nicht im DNS.
Warum schlägt DKIM nur manchmal fehl?
Achten Sie auf vorübergehende DNS-Fehler, auf E-Mails, die unterschiedliche Wege nehmen (manche über ein Gateway oder eine Liste), oder auf eine Rotation, bei der ein Schlüssel zu früh entfernt wurde.
Kann ich DKIM über Mailinglisten hinweg retten?
Von der Absenderseite aus nicht zuverlässig. Siehe DKIM bei Mailinglisten und Weiterleitungen.