Pular para o conteúdo
Português - Brasil
  • Não há sugestões porque o campo de pesquisa está em branco.

Por que as assinaturas DKIM falham

As assinaturas DKIM normalmente falham por um de dois motivos: a mensagem foi alterada depois de assinada, ou o destinatário não conseguiu encontrar uma chave pública utilizável no seletor indicado na assinatura. Problemas temporários de DNS e erros na assinatura causam o resto. Cada um precisa de uma correção diferente. Um rodapé adicionado depois da assinatura não se resolve republicando o seu registro DNS, e um registro ausente não se resolve mudando o seu gateway de e-mail. E, se o DKIM passou mas o DMARC não, isso nem é uma falha do DKIM. É alinhamento (alignment).

O que significa “DKIM fail”

Quando um destinatário verifica uma assinatura, ele retorna uma falha permanente (PERMFAIL) ou temporária (TEMPFAIL), com um motivo curto entre colchetes, como “body hash did not verify” ou “no key for signature”. Os destinatários normalmente registram o resultado no cabeçalho Authentication-Results como fail, neutral, policy, temperror ou permerror. Uma linha típica:

Authentication-Results: mx.receiver.example;
  dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026

header.d é o domínio que assina e header.s é o seletor. Esses dois, mais o texto do motivo, dizem com qual família de problema você está lidando.

Uma falha do DKIM, por si só, não faz o destinatário rejeitar a mensagem. Uma assinatura com falha não obriga a rejeição. O que acontece depois depende da filtragem do destinatário e da sua política DMARC. Para remetentes em massa que enviam ao Gmail, porém, uma falha do DKIM tem um custo direto. O Gmail lista estas respostas:

  • 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.”

As regras mais amplas dos provedores estão em Requisitos para remetentes do Google, do Yahoo e da Microsoft.

Motivos comuns de falha do DKIM

1. A mensagem mudou depois da assinatura (“body hash did not verify”)

Se o DKIM “funcionava ontem”, comece por aqui.

“Body hash did not verify” significa que o corpo mudou depois de ser assinado. O Google diz isso claramente: se o texto ao lado da entrada do DKIM for “body hash did not verify”, a mensagem foi modificada durante o transporte. Os culpados típicos:

  • Um gateway de saída ou uma ferramenta de aviso legal que adiciona um rodapé depois que a sua plataforma de e-mail assinou a mensagem. O Google alerta exatamente sobre isso.
  • Ferramentas de reescrita de links ou de rastreamento que editam o corpo depois da assinatura.
  • Listas de e-mail que acrescentam rodapés (DKIM, listas de e-mail e encaminhamento).

Se você vir esse erro no Microsoft 365, ele significa a mesma coisa: algo no caminho editou o corpo depois da assinatura.

“Signature did not verify” com um hash do corpo que bate pode significar que um cabeçalho assinado mudou. Uma lista que acrescenta [tag] ao Subject é o caso clássico.

Mudanças de codificação também contam. Converter conteúdo de 8 bits para 7 bits durante o transporte quebra as assinaturas DKIM, por isso quem assina deveria codificar a mensagem antes de assinar, da forma como se espera que ela seja recebida.

A canonicalização importa. simple quebra com quase qualquer mudança; relaxed tolera espaços em branco e cabeçalhos com quebras de linha refeitas, mas não edições de conteúdo. O Microsoft 365 usa relaxed por padrão tanto para o cabeçalho quanto para o corpo.

A correção: assine depois do último sistema que modifica a mensagem, ou impeça que esse sistema mexa no conteúdo assinado. A mesma recomendação vale para listas de e-mail: assine depois que a mensagem estiver preparada para distribuição. Não mude o DNS e não gere chaves novas. Nenhuma dessas coisas ajuda um corpo que foi reescrito.

2. O destinatário não consegue encontrar ou ler a chave

O destinatário consulta exatamente <s=>._domainkey.<d=>. Se essa consulta falhar, o resultado depende do motivo:

  • No key for signature (PERMFAIL). Nada está publicado nesse nome. Nunca foi publicado, foi publicado com o nome de host errado (a Microsoft destaca o domínio duplicado, como selector1._domainkey.example.com.example.com), está na zona DNS errada, o seletor está escrito errado, ou a chave foi excluída cedo demais durante uma rotação (Como fazer a rotação de uma chave DKIM). Se o remetente assina com um seletor ou um domínio d= que você nunca publicou, o caso também cai aqui. O diagnóstico completo de “nenhum registro” está em Assinatura DKIM não encontrada.
  • Key unavailable (TEMPFAIL). O DNS não respondeu. Esse é o único caso em que uma resposta SMTP temporária 4xx é adequada. No Microsoft 365, o dkim=temperror intermitente muitas vezes está ligado a TTLs muito baixos nos CNAMEs do DKIM; recomenda-se um TTL de pelo menos 3600 segundos.
  • Key syntax error (PERMFAIL). O registro está malformado. O caso clássico é uma chave de 2048 bits cortada em 255 caracteres, ou strings divididas armazenadas fora de ordem (Chaves DKIM de 1024 ou 2048 bits).
  • Key revoked (PERMFAIL). O registro tem um p= vazio. Isso é uma desativação deliberada, então os e-mails ainda assinados com essa chave falham.
  • Tipo de registro errado. Um TXT onde o provedor espera um CNAME, ou um CNAME com proxy pelo Cloudflare em vez de configurado como DNS only.
  • Cedo demais. Uma chave nova pode levar até 48 horas para começar a funcionar.

Os formatos de registro e a armadilha do domínio duplicado estão em Seletores DKIM e registros DNS.

3. A própria assinatura está configurada errada

Estes são problemas de configuração de quem assina, e são falhas permanentes:

  • Falta uma tag obrigatória (v, a, b, bh, d, h, s).
  • O cabeçalho From não está em h= (“From field not signed”).
  • O domínio i= não é o domínio d= nem um subdomínio dele (“domain mismatch”).
  • A assinatura expirou (x= está no passado). Os verificadores podem reprová-la, o que afeta principalmente e-mails muito atrasados ou reenviados.
  • O algoritmo é rsa-sha1, que tem avaliação de falha permanente, ou a chave RSA tem menos de 1024 bits.

Duas configurações relacionadas também merecem uma verificação:

  • A tag de tamanho do corpo l= deixa sem verificação o conteúdo que ultrapassa o limite. Isso pode ser explorado, e os avaliadores podem ignorar assinaturas que usam essa tag. Não use l=, porque as mensagens que a usam ficam vulneráveis a abusos.
  • Um registro de chave com t=y (teste) não é uma falha, mas os destinatários devem tratar os e-mails como não assinados, então você não tem nenhum benefício do DKIM.

Se você envia e-mails de marketing com cancelamento de inscrição com um clique, verifique também se os cabeçalhos de lista estão em h=. A mensagem precisa ter uma assinatura DKIM válida que cubra pelo menos List-Unsubscribe e List-Unsubscribe-Post.

4. A falha aconteceu depois que a mensagem saiu de você

O encaminhamento simples normalmente mantém o DKIM intacto. Listas de e-mail que marcam o assunto, acrescentam rodapés ou reescrevem partes MIME normalmente o quebram. Mensagens encaminhadas podem falhar no DKIM mesmo quando a sua configuração está correta. Você não consegue resolver isso totalmente do lado do envio. Consulte DKIM, listas de e-mail e encaminhamento.

Quando o DKIM passou para o domínio errado

Às vezes o relatório diz dkim=pass e o DMARC continua sem passar. Isso não é uma falha do DKIM. A assinatura foi verificada, mas o domínio d= dela não está alinhado com o seu domínio From. Uma assinatura válida de d=vendor.example não é um pass alinhado do DKIM para From: news@example.com. O DMARC ainda passa se houver outro pass alinhado do SPF ou do DKIM. A Microsoft lista exatamente esse sintoma na solução de problemas de DKIM, e a resposta 4.7.32 do Gmail diz que o cabeçalho From “isn’t aligned with either the authenticated SPF or DKIM organizational domain.”

Com o alinhamento relaxado, a correção é uma assinatura cujo d= compartilhe o seu domínio organizacional, como d=example.com ou d=mail.example.com. Você não precisa do domínio From exato. O alinhamento é tratado em Alinhamento de identificadores para SPF e DKIM, e a versão desse problema com terceiros, em E-mails de terceiros falham no alinhamento.

Há também uma particularidade do Gmail. O Gmail verifica apenas as cinco primeiras assinaturas listadas em Authentication-Results. Se a sua assinatura alinhada não estiver entre elas, a mensagem falha no DKIM, e isso também pode fazer a mensagem falhar no DMARC.

Como diagnosticar uma falha do DKIM, em ordem

  1. Leia o Authentication-Results em uma cópia recebida. Anote o resultado dkim=, o texto do motivo, header.d e header.s.
  2. “Body hash did not verify” → procure gateways, ferramentas de rodapé, reescritores de rastreamento ou listas no caminho (motivo 1).
  3. “No key”, permerror ou um erro de sintaxe da chave → consulte o seletor no DNS e compare com o valor que o seu provedor lhe deu (motivo 2).
  4. temperror → tente de novo mais tarde e depois verifique o seu provedor de DNS e os TTLs (motivo 2).
  5. dkim=pass, mas sem pass do DMARC → compare header.d com o domínio From (seção anterior).
  6. Verifique a escala. Os seus relatórios agregados do DMARC mostram o domínio DKIM, o seletor e o resultado por fonte. Se uma fonte falha e as demais passam, o problema está na configuração ou no caminho desse remetente, e não no “DKIM do domínio inteiro” (Um relatório agregado DMARC explicado campo a campo).

Erros que vale a pena evitar

  • Presumir que uma falha do DKIM significa que o registro DNS está errado. Um corpo alterado é uma causa comum, e nenhuma mudança no DNS resolve isso.
  • Presumir que uma falha significa que um atacante adulterou o e-mail. Um gateway ou uma lista legítimos também podem alterar o conteúdo assinado.
  • Gerar chaves novas para corrigir uma falha de hash do corpo. Isso não muda nada.
  • Publicar a chave e nunca ativar a assinatura. O Google tem uma etapa Iniciar autenticação; o Microsoft 365 tem a sua própria configuração de ativação (Problemas de configuração no Microsoft 365 ou no Google Workspace).
  • Usar l= para que os rodapés não quebrem a assinatura.

Conta DMARC gratuita

Transforme relatórios DMARC brutos em um painel fácil de ler

Aponte seu endereço rua para a nossa plataforma e leia os resultados por remetente e por fonte, em vez de abrir arquivos XML.

  • Resultados agrupados por fonte de envio
  • Resultados de SPF, DKIM e alinhamento por remetente
  • Os relatórios XML originais continuam disponíveis para download

Criar uma conta DMARC gratuitaFalar com um especialista

Perguntas frequentes

Por que o meu DKIM está falhando?

Comece pelo texto do motivo em Authentication-Results. “Body hash did not verify” significa que algo mudou o corpo depois da assinatura. “No key” ou um erro de sintaxe significa que o registro está ausente, no lugar errado ou truncado. temperror significa que o DNS não respondeu.

O que significa “body hash did not verify”?

Que o corpo mudou depois da assinatura, normalmente por causa de um rodapé, de um gateway ou de uma lista. Corrija o sistema que modifica a mensagem, não o DNS.

Por que o DKIM falha só às vezes?

Procure erros temporários de DNS, e-mails que seguem caminhos diferentes (alguns por um gateway ou uma lista) ou uma rotação que removeu uma chave cedo demais.

Posso fazer o DKIM sobreviver às listas de e-mail?

Não de forma confiável a partir do lado do envio. Consulte DKIM, listas de e-mail e encaminhamento.