Pular para o conteúdo
DMARC Pulse

Erros de e-mail

DKIM fail: o que dkim=fail significa e como corrigir

DKIM fail significa que o destino não conseguiu verificar sua assinatura. Entenda o dkim=fail no cabeçalho, ache a causa da falha e corrija.

O que isso significa

DKIM fail significa que o servidor de destino encontrou uma assinatura DKIM na sua mensagem e não conseguiu verificá-la. O DKIM assina cada mensagem com uma chave privada, e o destino confere a assinatura com a chave pública do seu DNS.

A RFC 8601 define os resultados de dkim= no cabeçalho Authentication-Results:

  • fail: a assinatura foi verificada e falhou.
  • neutral: a assinatura tinha erros de sintaxe ou não pôde ser processada.
  • permerror e temperror: um erro irrecuperável ou provavelmente temporário impediu a verificação.
  • none: a mensagem não foi assinada. Comece pela configuração do DKIM.

O DMARC, a política baseada em SPF e DKIM, só considera assinaturas válidas. Uma assinatura válida alinhada ao domínio do From basta, mesmo que outra falhe.

Quando o relatório DMARC diz que o DKIM falhou

Nos relatórios agregados, auth_results traz o resultado puro da verificação. O dkim de policy_evaluated é o teste de alinhamento. Um fail ali com pass em auth_results indica uma assinatura válida cujo domínio não está alinhado com o do seu From. Faça o serviço assinar com seu domínio.

Por que acontece

Uma falha em todas as mensagens aponta para a chave ou quem assina. Em um só caminho, aponta para um sistema que alterou a mensagem.

  • Chave errada ou ausente. A Microsoft cita uma chave no DNS que não corresponde à privada ou um registro ausente.
  • Mensagem alterada. body hash did not verify indica que o corpo mudou e tem correção própria. signature did not verify significa que a assinatura b= não confere com os cabeçalhos em h= e a chave pública. Listas de e-mail, regras de transporte e gateways podem alterar a mensagem após a assinatura.
  • Registro da chave danificado. O Google avisa que uma chave de 2048 bits não cabe em uma string TXT de 255 caracteres e pode ficar truncada. Um p= vazio indica chave revogada.
  • Configuração obsoleta. Pela RFC 8301, assinaturas rsa-sha1 e chaves RSA com menos de 1024 bits falham permanentemente.
  • Consulta da chave falhou. temperror pode sumir em uma nova tentativa. Quando a consulta da chave expira, a Microsoft aponta um registro TXT grande demais ou um servidor DNS autoritativo lento.

Como corrigir

  1. Cole o cabeçalho completo de uma mensagem que falhou no Analisador de Cabeçalho.

  2. Anote o resultado dkim= que falhou e o motivo. Do DKIM-Signature que corresponde a header.d ou header.i, anote d= (domínio que assinou), s= (seletor, que escolhe a chave) e a= (algoritmo).

  3. Informe d= e s= no Verificador DKIM. Para s=s1 e d=exemplo.com.br, a chave fica em s1._domainkey.exemplo.com.br. Deve haver um registro com valor em p=.

  4. Compare com o valor do serviço de envio. Se o seletor for um CNAME, compare o destino e mantenha o CNAME.

  5. Se o registro não existir ou for diferente, publique o valor exato do serviço. Se o DNS limitar cada string a 255 caracteres, divida o valor em strings entre aspas, na ordem. Mantenha um único registro TXT por seletor.

    Cuidado: trocar uma chave em uso quebra o DKIM do e-mail assinado com ela. Se o SPF não passar alinhado ao domínio do seu From e a política for p=quarantine ou p=reject, o destino pode mandar esse e-mail para o spam ou rejeitá-lo. Se puder, publique um novo seletor e confirme que aparece no DNS antes de o serviço assinar. A RFC 6376 recomenda manter a chave antiga por tempo razoável.

  6. Para rsa-sha1, assine com rsa-sha256. Para chave curta, gere uma chave RSA de pelo menos 2048 bits, como recomenda a RFC 8301, com o mesmo cuidado.

  7. Se o DNS estiver certo e só um caminho falhar, descubra qual sistema reescreve a mensagem. Interrompa a reescrita, ou faça-o assinar depois das alterações e publique a chave dele antes. Se todos falharem, confira quem assina, qualquer gateway compartilhado e se h= inclui From.

Confirme a correção

  1. Espere o registro antigo expirar e envie uma mensagem nova pelo caminho que falhou para uma caixa postal sua.
  2. Procure dkim=pass com seu domínio em header.d ou header.i. Para o DMARC, ele também precisa estar alinhado ao domínio do From.
  3. Nos próximos relatórios agregados, dkim deve indicar pass em auth_results e policy_evaluated para a origem corrigida.

Verifique agora

Encontre e valide chaves DKIM

Perguntas frequentes

dkim=neutral é a mesma coisa que dkim=fail?
Os dois rótulos têm significados diferentes. A RFC 8601 usa fail quando a assinatura foi verificada e falhou. Ela usa neutral para erros de sintaxe, assinaturas que não puderam ser processadas e outras falhas que não estão na lista dela. Nenhum dos dois dá ao DMARC um pass de DKIM. Nem todo servidor mostra todos os valores. O guia de solução de problemas da Microsoft lista só pass, fail e none para esse cabeçalho, então lá uma chave ausente pode aparecer como fail.
Uma falha de DKIM faz meu e-mail ser rejeitado?
A RFC 6376 diz que, em geral, quem recebe não deve decidir a aceitação com base apenas em uma assinatura que não pôde ser verificada. A rejeição ainda pode acontecer, porque cada servidor define as próprias regras. O Gmail, por exemplo, exige que todo remetente se autentique com SPF ou DKIM, então uma mensagem que não passa em nenhum dos dois pode ser bloqueada com 550 5.7.26, mesmo sem política DMARC. O DMARC é outra via. Se nem o SPF nem o DKIM gerarem um pass alinhado e todas as consultas DNS tiverem sido concluídas, a mensagem falha no DMARC. O servidor de destino então aplica a política local dele, que pode levar em conta o valor do seu p=. Se um erro de DNS temporário ou permanente impedir uma consulta necessária, a mensagem não passa nem falha no DMARC, e sua política não pode ser aplicada.
Por que o DKIM passa em um destinatário e falha em outro?
Os caminhos podem ser diferentes, e um encaminhador ou servidor intermediário em um deles pode alterar a mensagem. Cada servidor também aplica os próprios limites. O Gmail, por exemplo, verifica apenas as 5 primeiras assinaturas listadas no cabeçalho Authentication-Results.
Meu registro DKIM existe. Por que o DKIM continua falhando?
Um registro pode existir e estar errado. Ele pode ter uma chave antiga, estar truncado ou dividir o seletor com um segundo registro. Um cabeçalho assinado também pode mudar no caminho. Compare o valor publicado com o que aparece no serviço que envia seus e-mails. No Microsoft 365, o DKIM usa registros CNAME, e uma chave em TXT nesses nomes não é suportada.
Preciso corrigir o DKIM se o SPF já passa?
O DMARC precisa de um pass alinhado, então um pass de SPF alinhado já basta para a mensagem passar no DMARC. Isso vale só para o DMARC. Se você envia mais de 5.000 mensagens por dia para contas do Gmail, o Gmail exige SPF e DKIM configurados, então corrija o DKIM de qualquer forma. A Microsoft observa que e-mail encaminhado falha no SPF quando o IP do servidor que encaminhou não está no registro SPF de quem enviou. Uma assinatura DKIM válida e alinhada dá uma segunda rota para o pass de DMARC quando a mensagem não é alterada.
Como vejo o cabeçalho completo no Gmail?
No navegador, abra a mensagem. Ao lado de Responder, clique em Mais e depois em Mostrar original. O cabeçalho completo abre em uma nova janela.

Fontes consultadas

RFC 8601 §2.7.1: resultados de DKIM
consultada em 2026-11-08
RFC 6376 §3.6.2.1: namespace
consultada em 2026-11-08
Gmail Help: Email sender guidelines
consultada em 2026-11-08

Páginas relacionadas

Mantenha tudo saudável

Saiba na hora quando algo quebrar

Aponte seus relatórios DMARC para o DMARC Pulse e veja quem envia e-mail em nome do seu domínio, o que falha e por quê — com um alerta tranquilo quando algo mudar.

Plano grátis: 1 domínio, sem cartão de crédito.