Erros de e-mail
DKIM body hash did not verify: causas e como corrigir
DKIM body hash did not verify significa que a mensagem não bate mais com o valor bh= da assinatura. Descubra o que a alterou e confirme o dkim=pass.
O que isso significa
DKIM body hash did not verify significa que a assinatura falhou: o servidor de destino recalculou o hash do corpo e ele não bate com a tag bh= da assinatura, que guarda uma impressão digital do conteúdo.
A RFC 6376 chama isso de PERMFAIL (body hash did not verify). O Microsoft 365 escreve:
dkim=fail (body hash did not verify) header.d=exemplo.com.br
Já signature did not verify vem da verificação dos cabeçalhos assinados com sua chave pública. Veja DKIM fail. A comparação do corpo não usa chave, então trocar a chave ou o DNS não resolve este erro.
DKIM-Signature body hash not verified
O MxToolbox mostra DKIM-Signature Body Hash Not Verified para a mesma divergência. A Broadcom avisa que essas ferramentas recalculam o hash a partir do que você cola e podem gerar um alarme falso. Confie no Authentication-Results do servidor de destino.
Por que acontece
O corpo mudou depois da assinatura, ou foi assinada uma versão diferente da enviada. Verifique:
- Gateways e regras de transporte que acrescentam rodapé, aviso legal ou nota de verificação.
- Listas de e-mail, que acrescentam linhas, reformatam partes MIME ou trocam anexos grandes por links.
- Encaminhadores que editam o conteúdo. Retransmitir costuma manter as assinaturas válidas (RFC 9989), mas o Google avisa que e-mails encaminhados podem falhar no DKIM.
- Filtro de outro fornecedor na frente de uma caixa do Microsoft 365, que pode alterar a mensagem antes da entrega.
- Codificação e fim de linha. Converter texto de 8 para 7 bits no caminho quebra assinaturas. CR ou LF isolados precisam virar CRLF antes da assinatura.
A tag c= define a tolerância (canonicalização); depois da barra vem a regra do corpo. simple ignora só as linhas vazias finais. relaxed também ignora espaços em fim de linha e reduz sequências de espaços ou tabulações a um espaço. Com c=relaxed sozinho ou sem c=, o corpo usa simple. Nenhuma regra tolera texto acrescentado.
Como corrigir
-
Copie o cabeçalho completo de uma mensagem que falhou. No Gmail, clique em Mais ao lado de Responder e em Mostrar original. Cole tudo no analisador de cabeçalhos de e-mail. Se houver várias assinaturas, compare
header.douheader.ido resultado que falhou com oDKIM-Signaturedele. -
Veja o alcance. O Google recomenda verificar se outras origens autorizadas do domínio também falham no DKIM. Se falharem várias, procure algo em comum, como um gateway.
-
Refaça o caminho. Cada servidor SMTP acrescenta uma linha
Receivedno topo: leia de baixo para cima e liste os sistemas após quem assinou. Se esses sistemas acrescentaram linhasAuthentication-Results, a mudança está entre o últimodkim=passe o primeirodkim=faildessa assinatura. Se não, comece pelas causas acima. -
Assine por último. Peça a quem opera o sistema encontrado que pare de alterar a mensagem, leve o rodapé para o sistema que assina ou faça o gateway assinar depois.
Cuidado: se um sistema novo for assinar, publique a chave dele em um seletor novo (o rótulo da chave no DNS) e confirme com o verificador de DKIM que ela resolve antes da troca. Sem chave publicada, a assinatura também falha. Com
p=quarantineoup=reject, e-mails sem outropassalinhado podem ir para o spam ou ser recusados. Teste em um fluxo pequeno e mantenha o seletor antigo publicado até os e-mails assinados com ele serem entregues. -
Para mudanças de espaço, use
c=relaxed/relaxedse o sistema permitir. Para codificação, converta conteúdo de 8 bits para quoted-printable ou base64 antes de assinar. -
Se recebe esses e-mails no Microsoft 365, não pode mudar o serviço e ele acrescenta cabeçalhos
ARC-Seal, adicione o domínio dod=deles (do fornecedor, não o seu) como selador ARC confiável. O ARC (Authenticated Received Chain) preserva os resultados originais de autenticação. Adicione só serviços que você usa: a Microsoft alerta que seladores desnecessários aumentam a superfície de ataque.
Confirme a correção
Envie outra mensagem pelo mesmo caminho. Procure dkim=pass com seu domínio em header.d ou header.i, no destinatário que relatou a falha. Se usou o passo 6, dkim=fail continua no cabeçalho: procure compauth=pass reason=130, em uma mensagem enviada pelo menos 30 minutos depois da mudança.
Depois acompanhe os relatórios agregados de DMARC dessa origem. Trazem resultado DKIM, domínio e seletor.