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.permerroretemperror: 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 verifyindica que o corpo mudou e tem correção própria.signature did not verifysignifica que a assinaturab=não confere com os cabeçalhos emh=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-sha1e chaves RSA com menos de 1024 bits falham permanentemente. - Consulta da chave falhou.
temperrorpode 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
-
Cole o cabeçalho completo de uma mensagem que falhou no Analisador de Cabeçalho.
-
Anote o resultado
dkim=que falhou e o motivo. DoDKIM-Signatureque corresponde aheader.douheader.i, anoted=(domínio que assinou),s=(seletor, que escolhe a chave) ea=(algoritmo). -
Informe
d=es=no Verificador DKIM. Paras=s1ed=exemplo.com.br, a chave fica ems1._domainkey.exemplo.com.br. Deve haver um registro com valor emp=. -
Compare com o valor do serviço de envio. Se o seletor for um CNAME, compare o destino e mantenha o CNAME.
-
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=quarantineoup=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. -
Para
rsa-sha1, assine comrsa-sha256. Para chave curta, gere uma chave RSA de pelo menos 2048 bits, como recomenda a RFC 8301, com o mesmo cuidado. -
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=incluiFrom.
Confirme a correção
- Espere o registro antigo expirar e envie uma mensagem nova pelo caminho que falhou para uma caixa postal sua.
- Procure
dkim=passcom seu domínio emheader.douheader.i. Para o DMARC, ele também precisa estar alinhado ao domínio do From. - Nos próximos relatórios agregados,
dkimdeve indicarpassemauth_resultsepolicy_evaluatedpara a origem corrigida.