При DKIM-ошибке начинайте не с панели DNS, а с исходника письма у получателя. В `DKIM-Signature` найдите домен `d=` и selector `s=`, затем запросите TXT по адресу `s._domainkey.d`. Если ключ найден, различите обычный signature fail и `body hash did not verify`: во втором случае письмо изменилось после подписи.
Не публикуйте новый ключ поверх старого selector во время активной отправки. Создайте другой selector, дождитесь доступности TXT с внешних резолверов, переключите signer и оставьте прежний публичный ключ на время прохождения уже отправленных писем. Private key никогда не кладётся в DNS и не передаётся в тикет.
Одна строка результата сужает поиск
| Результат | Граница сбоя | Следующая проверка |
|---|---|---|
| dkim=none | Подпись не добавлена | Маршрут отправки и signer для From domain |
| no key for signature | TXT не найден | s=, d=, DNS zone и propagation |
| key syntax / invalid public key | Повреждён TXT | Склейка кавычек, p= и тип записи |
| signature did not verify | Headers или ключ не совпали | h=, canonicalization и активный private key |
| body hash did not verify | Body/MIME изменён после подписи | Footer, tracking, transfer encoding, gateway |
| dkim=pass, dmarc=fail | Проблема alignment, не криптография DKIM | Сопоставить d= с доменом From |
RFC 6376 описывает два вычисления: хеш канонизированного тела сравнивается с `bh=`, а подпись заголовков проверяется публичным ключом из DNS. Поэтому наличие TXT само по себе не доказывает, что конкретное письмо подписано правильным private key и не было изменено.
Hostname строится только из полученной подписи
From: Billing <billing@example.com>
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=example.com; s=mail2026; h=from:to:subject:date;
bh=BASE64_BODY_HASH; b=BASE64_SIGNATURE
DNS name: mail2026._domainkey.example.com
Expected TXT prefix: v=DKIM1; k=rsa; p=Не угадывайте selector по названию провайдера. Берите `s=` из проблемного сообщения: разные потоки и старые письма могут использовать разные ключи. Убедитесь, что TXT опубликован в authoritative zone домена `d=`, а не только виден в панели другого DNS-провайдера.
Подписывают окончательный MIME
Sign operation должна выполняться после генерации HTML/text частей, вложений, transfer encoding и служебных заголовков, которые перечислены в `h=`. Если CRM, relay или security gateway после этого добавляет footer, переписывает Subject либо меняет MIME boundaries, подпись может перестать сходиться.
- Сравните raw message до signer и raw source у конечного получателя.
- Проверьте, какой узел первым добавляет DKIM-Signature.
- Отключайте модификацию только для тестового маршрута, а не глобально.
- Не используйте `l=` как универсальный способ разрешить дописывание тела.
- Для рассылок через несколько провайдеров заведите отдельные selectors и аудит ключей.
Ротация не создаёт окно без ключа
Новый selector удобнее замены `p=` под прежним именем: старые письма продолжают проверяться старым ключом, новые — новым. Сначала DNS, затем signer, затем контрольное письмо. Удалять старый TXT можно после согласованного окна доставки и подтверждения, что им больше не подписывает ни один узел.
Google рекомендует DKIM и SPF для аутентификации отправителей и отдельно проверяет alignment для требований DMARC. Поэтому после `dkim=pass` убедитесь, что домен подписи согласован с видимым From по вашей DMARC-политике.
Контрольное письмо проходит тот же маршрут
Отправьте небольшой plain+HTML message через production-подобный путь на два внешних домена. Сохраните Message-ID, raw headers и Authentication-Results. Затем повторите письмо с типичным footer и вложением: это выявит модификацию, которая не видна на простом тесте.
Для диагностики подготовьте bounce code, `Authentication-Results`, `DKIM-Signature` без содержимого письма, TXT публичного ключа и список relay-узлов. Private key, адреса получателей и тело рабочих писем удалите.