Dlaczego podpisy DKIM nie przechodzą weryfikacji
Podpisy DKIM zwykle zawodzą z jednego z dwóch powodów: wiadomość została zmieniona po podpisaniu albo odbiorca nie znalazł użytecznego klucza publicznego pod selektorem wskazanym w podpisie. Resztę przypadków powodują przejściowe problemy z DNS i błędy w podpisywaniu. Każdy z nich wymaga innej poprawki. Stopki dodanej po podpisaniu nie naprawi ponowne opublikowanie rekordu DNS, a brakującego rekordu nie naprawi zmiana bramy pocztowej. A jeśli DKIM przeszedł, ale DMARC nadal nie, to wcale nie jest błąd DKIM. To kwestia dopasowania (alignment).
Co oznacza „DKIM fail”
Gdy odbiorca sprawdza podpis, zwraca błąd trwały (PERMFAIL) albo przejściowy (TEMPFAIL) z krótkim powodem w nawiasie, na przykład „body hash did not verify” lub „no key for signature”. Odbiorcy zwykle zapisują wynik w nagłówku Authentication-Results jako fail, neutral, policy, temperror lub permerror. Typowy wiersz:
Authentication-Results: mx.receiver.example;
dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026
header.d to domena podpisująca, a header.s to selektor. Te dwie wartości wraz z tekstem powodu wskazują, z jaką grupą problemów ma się do czynienia.
Błąd DKIM sam w sobie nie sprawia, że odbiorca odrzuca wiadomość. Nieudany podpis nie wymusza odrzucenia. To, co dzieje się dalej, zależy od filtrowania u odbiorcy i od polityki DMARC domeny. W przypadku nadawców masowych wysyłających do Gmaila błąd DKIM ma jednak bezpośredni koszt. Gmail wymienia następujące odpowiedzi:
- 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.”
Szersze zasady dostawców opisuje artykuł Wymagania Google, Yahoo i Microsoftu wobec nadawców.
Najczęstsze przyczyny błędów DKIM
1. Wiadomość zmieniła się po podpisaniu („body hash did not verify”)
Jeśli DKIM „wczoraj działał”, warto zacząć od tego punktu.
„Body hash did not verify” oznacza, że treść zmieniła się po podpisaniu. Google ujmuje to wprost: jeśli tekst obok wpisu DKIM to „body hash did not verify”, „wiadomość została zmodyfikowana podczas przesyłania”. Typowi winowajcy:
- Brama wychodząca lub narzędzie do zastrzeżeń prawnych, które dodaje stopkę po tym, jak platforma pocztowa podpisała wiadomość. Google ostrzega właśnie przed tym.
- Narzędzia do przepisywania linków lub śledzenia, które edytują treść po podpisaniu.
- Listy mailingowe dopisujące stopki (DKIM a listy mailingowe i usługi przekierowania).
Ten sam błąd w Microsoft 365 oznacza to samo: coś na trasie zmodyfikowało treść po podpisaniu.
„Signature did not verify” przy zgodnym skrócie treści może oznaczać, że zmienił się podpisany nagłówek. Klasycznym przykładem jest lista dodająca [tag] do tematu.
Zmiany kodowania również się liczą. Konwersja treści 8-bitowej na 7-bitową w trakcie przesyłania łamie podpisy DKIM, dlatego podpisujący powinni zakodować wiadomość przed podpisaniem w takiej postaci, w jakiej ma zostać odebrana.
Kanonikalizacja ma znaczenie. simple łamie się przy niemal każdej zmianie; relaxed toleruje białe znaki i ponownie zawinięte nagłówki, ale nie zmiany treści. Microsoft 365 domyślnie używa relaxed zarówno dla nagłówka, jak i treści.
Poprawka: podpisywać po ostatnim systemie, który modyfikuje wiadomość, albo nie pozwolić temu systemowi ingerować w podpisaną treść. Ta sama rada dotyczy list mailingowych: podpisywać po przygotowaniu wiadomości do dystrybucji. Nie należy zmieniać DNS ani generować kluczy od nowa. Żadne z tych działań nie pomoże w przypadku przepisanej treści.
2. Odbiorca nie może znaleźć ani odczytać klucza
Odbiorca wyszukuje dokładnie <s=>._domainkey.<d=>. Jeśli to wyszukiwanie się nie powiedzie, wynik zależy od przyczyny:
- No key for signature (PERMFAIL). Pod tą nazwą nic nie opublikowano. Rekord nigdy nie został opublikowany, trafił pod niewłaściwą nazwę hosta (Microsoft wskazuje podwojoną domenę, np.
selector1._domainkey.example.com.example.com), znajduje się w niewłaściwej strefie DNS, selektor ma literówkę albo klucz usunięto zbyt wcześnie podczas rotacji (Jak przeprowadzić rotację klucza DKIM). Jeśli nadawca podpisuje selektorem lub domenąd=, które nigdy nie zostały opublikowane, również trafia się tutaj. Pełną diagnozę braku rekordu opisuje artykuł Nie znaleziono podpisu DKIM. - Key unavailable (TEMPFAIL). DNS nie odpowiedział. To jedyny przypadek, w którym właściwa jest przejściowa odpowiedź SMTP 4xx. W Microsoft 365 sporadyczny wynik
dkim=temperrorczęsto wiąże się z bardzo niskimi wartościami TTL rekordów CNAME DKIM; zalecany jest TTL co najmniej 3600 sekund. - Key syntax error (PERMFAIL). Rekord jest nieprawidłowo sformułowany. Klasycznym przypadkiem jest klucz 2048-bitowy obcięty na 255 znakach lub podzielone ciągi zapisane w złej kolejności (Klucze DKIM: 1024 czy 2048 bitów).
- Key revoked (PERMFAIL). Rekord ma puste
p=. To celowe wycofanie, więc poczta nadal podpisywana tym kluczem nie przechodzi weryfikacji. - Niewłaściwy typ rekordu. TXT tam, gdzie dostawca oczekuje CNAME, albo CNAME przepuszczony przez proxy Cloudflare zamiast ustawienia DNS only.
- Za wcześnie. Nowy klucz może zacząć działać dopiero po 48 godzinach.
Formaty rekordów i pułapkę podwojonej domeny opisuje artykuł Selektory DKIM i rekordy DNS.
3. Sam podpis jest źle skonfigurowany
To problemy z konfiguracją po stronie podpisującego i są to błędy trwałe:
- Brakuje wymaganego tagu (
v,a,b,bh,d,h,s). - Nagłówka From nie ma w
h=(„From field not signed”). - Domena
i=nie jest domenąd=ani jej subdomeną („domain mismatch”). - Podpis wygasł (
x=wskazuje przeszłość). Weryfikatorzy mogą uznać go za nieudany, co dotyczy głównie poczty bardzo opóźnionej lub odtworzonej. - Algorytm to
rsa-sha1, który jest trwale oceniany jako nieudany, albo klucz RSA jest krótszy niż 1024 bity.
Warto sprawdzić także dwa powiązane ustawienia:
- Tag długości treści
l=pozostawia treść poza limitem niezweryfikowaną. Można to nadużyć, a oceniający mogą ignorować podpisy z tym tagiem. Nie należy używaćl=, ponieważ wiadomości z tym tagiem są podatne na nadużycia. - Rekord klucza z
t=y(testowanie) nie jest błędem, ale odbiorcy muszą traktować taką pocztę jak niepodpisaną, więc DKIM nie daje żadnej korzyści.
Przy wysyłce poczty marketingowej z rezygnacją jednym kliknięciem należy też sprawdzić, czy h= obejmuje nagłówki listy. Wiadomość musi mieć ważny podpis DKIM obejmujący co najmniej List-Unsubscribe i List-Unsubscribe-Post.
4. Błąd wystąpił po wysłaniu
Zwykłe przekierowanie zwykle zachowuje DKIM. Listy mailingowe, które oznaczają tematy, dodają stopki lub przepisują części MIME, zwykle go łamią. Przekierowane wiadomości mogą nie przejść DKIM nawet przy poprawnej konfiguracji. Po stronie nadawcy nie da się tego w pełni naprawić. Zob. DKIM a listy mailingowe i usługi przekierowania.
Gdy DKIM przeszedł dla niewłaściwej domeny
Czasem raport pokazuje dkim=pass, a DMARC i tak nie przechodzi. To nie jest błąd DKIM. Podpis został zweryfikowany, ale jego domena d= nie jest dopasowana do domeny From. Ważny podpis od d=vendor.example nie jest dopasowanym wynikiem DKIM pass dla From: news@example.com. DMARC nadal przechodzi, jeśli istnieje inny dopasowany wynik pass SPF lub DKIM. Microsoft wymienia dokładnie ten objaw w swoim przewodniku rozwiązywania problemów z DKIM, a odpowiedź Gmaila 4.7.32 mówi, że nagłówek From „isn’t aligned with either the authenticated SPF or DKIM organizational domain”.
Przy dopasowaniu relaxed poprawką jest podpis, którego d= ma tę samą domenę organizacyjną, np. d=example.com lub d=mail.example.com. Dokładna domena From nie jest potrzebna. Dopasowanie opisuje artykuł Dopasowanie identyfikatorów w SPF i DKIM, a wersję tego problemu dotyczącą stron trzecich artykuł Poczta od nadawców zewnętrznych nie przechodzi dopasowania.
Jest też niuans specyficzny dla Gmaila. Gmail sprawdza tylko pięć pierwszych podpisów wymienionych w Authentication-Results. Jeśli dopasowanego podpisu nie ma wśród nich, wiadomość nie przechodzi DKIM, co „może również spowodować, że wiadomość nie przejdzie DMARC”.
Jak zdiagnozować błąd DKIM, krok po kroku
- Odczytać
Authentication-Resultsw odebranej kopii. Zanotować wynikdkim=, tekst powodu,header.diheader.s. - „Body hash did not verify” → szukać bram, narzędzi dodających stopki, narzędzi przepisujących linki do śledzenia lub list na trasie (przyczyna 1).
- „No key”, permerror lub key syntax error → wyszukać selektor w DNS i porównać go z wartością podaną przez dostawcę (przyczyna 2).
- temperror → ponowić próbę później, a następnie sprawdzić dostawcę DNS i wartości TTL (przyczyna 2).
dkim=pass, ale brak DMARC pass → porównaćheader.dz domeną From (poprzednia sekcja).- Sprawdzić skalę. Raporty zagregowane DMARC pokazują domenę DKIM, selektor i wynik dla każdego źródła. Jeśli jedno źródło nie przechodzi, a pozostałe tak, problem leży w konfiguracji lub trasie tego nadawcy, a nie w „DKIM dla całej domeny” (Raport zagregowany DMARC pole po polu).
Błędy, których warto unikać
- Założenie, że błąd DKIM oznacza błędny rekord DNS. Częstą przyczyną jest zmieniona treść, a tego nie naprawi żadna zmiana w DNS.
- Założenie, że błąd oznacza ingerencję atakującego w pocztę. Podpisaną treść może zmienić także legalna brama lub lista.
- Generowanie kluczy od nowa, aby naprawić błąd skrótu treści. To niczego nie zmienia.
- Opublikowanie klucza bez włączenia podpisywania. Google ma krok Rozpocznij uwierzytelnianie; Microsoft 365 ma własne ustawienie włączające (Problemy z konfiguracją Microsoft 365 lub Google Workspace).
- Używanie
l=, aby stopki nie łamały podpisu.
Bezpłatne konto DMARC
Surowe raporty DMARC w czytelnym panelu
Wystarczy skierować adres rua na naszą platformę, aby czytać wyniki według nadawcy i źródła zamiast otwierać pliki XML.
- Wyniki pogrupowane według źródła wysyłki
- Wyniki SPF, DKIM i dopasowania dla każdego nadawcy
- Oryginalne raporty XML nadal dostępne do pobrania
Najczęściej zadawane pytania
Dlaczego mój DKIM nie przechodzi weryfikacji?
Należy zacząć od tekstu powodu w Authentication-Results. „Body hash did not verify” oznacza, że coś zmieniło treść po podpisaniu. „No key” lub błąd składni oznacza, że rekordu brakuje, jest w złym miejscu albo jest obcięty. temperror oznacza, że DNS nie odpowiedział.
Co oznacza „body hash did not verify”?
Treść zmieniła się po podpisaniu, zwykle z powodu stopki, bramy lub listy. Należy poprawić system, który modyfikuje wiadomość, a nie DNS.
Dlaczego DKIM zawodzi tylko czasami?
Warto szukać przejściowych błędów DNS, poczty przechodzącej różnymi trasami (część przez bramę lub listę) albo rotacji, w której klucz usunięto zbyt wcześnie.
Czy można sprawić, by DKIM przetrwał listy mailingowe?
Nie w niezawodny sposób po stronie nadawcy. Zob. DKIM a listy mailingowe i usługi przekierowania.