Aprender
O que é DKIM? Assinatura e chaves DKIM explicadas
O que é DKIM? Uma assinatura que liga o e-mail a um domínio, conferida com uma chave pública no DNS. Como funciona, exemplo de registro e erros comuns.
O que é
O que é DKIM? O DKIM (DomainKeys Identified Mail) é um padrão de autenticação de e-mail que permite a um domínio assinar cada mensagem com uma chave privada, para que o servidor de destino confira a assinatura com uma chave pública publicada no DNS. A assinatura fica ligada a um nome de domínio e viaja em um cabeçalho da mensagem.
Uma assinatura válida mostra que um domínio assumiu a responsabilidade pela mensagem e que o conteúdo assinado não mudou desde a assinatura. O DKIM não criptografa nada. Uma verificação que falha não obriga, por si só, a rejeitar a mensagem. O domínio que assina também pode ser diferente do domínio do endereço From.
Como funciona a assinatura DKIM
- O sistema de envio calcula o hash do corpo da mensagem, uma impressão digital curta do conteúdo. O resultado vai para a tag
bh=de um novo cabeçalhoDKIM-Signature. - Ele assina com a chave privada os campos listados em
h=e o próprioDKIM-Signature. O resultado vai parab=. - O servidor de destino lê o domínio que assinou em
d=e o seletor ems=, que indica qual chave usar. Depois, busca a chave pública em um registro TXT do DNS, em<seletor>._domainkey.<domínio>. - Ele recalcula os hashes, compara o hash do corpo com
bh=e verificab=com a chave pública. Um servidor que adiciona o cabeçalhoAuthentication-Resultsregistra comodkim=passuma assinatura que passa na verificação e que a política local dele aceita.
O que é uma chave DKIM?
Uma chave DKIM é uma das metades de um par de chaves. A chave privada fica com o sistema que assina seus e-mails. A chave pública fica no DNS, para qualquer servidor de destino buscar.
Um domínio pode publicar várias chaves, uma por seletor, para que cada servidor ou provedor assine com a sua. No Google Workspace, o seletor padrão é google, publicado como registro TXT. Em domínio personalizado, o Microsoft 365 usa selector1._domainkey e selector2._domainkey como registros CNAME (apelidos de DNS).
A RFC 8301 proíbe rsa-sha1, exige chaves RSA de pelo menos 1024 bits e recomenda pelo menos 2048. Para criar uma chave, veja como configurar o DKIM.
DKIM e DMARC
O DKIM é um dos dois mecanismos por trás do DMARC, a verificação de política sobre o endereço From. O DMARC só conta um DKIM aprovado quando o domínio em d= está alinhado com o do From. No modo relaxado, que é o padrão, d=exemplo.com.br se alinha com e-mails enviados de news.exemplo.com.br.
Exemplo
Esta assinatura é ilustrativa. O seletor brisbane vem do exemplo da RFC 6376, e os valores longos estão encurtados.
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=exemplo.com.br; s=brisbane;
h=from:to:subject:date; bh=2jUSOH9NhtVGCQWN...; b=AuUoFEfDxTDkHlLXSZEp...
v=1ea=rsa-sha256: a versão da assinatura e o algoritmo.c=relaxed/relaxed: como o cabeçalho e o corpo são normalizados antes do hash, etapa chamada de canonicalização.relaxedtolera mudanças comuns, como novas quebras de linha nos cabeçalhos.simplequase não tolera mudanças.d=exemplo.com.bres=brisbane: o domínio que assume a responsabilidade e o seletor.h=: os campos de cabeçalho assinados.Fromprecisa estar entre eles.bh=eb=: o hash do corpo e a assinatura.
Neste exemplo, a chave pública ficaria em um registro TXT em brisbane._domainkey.exemplo.com.br:
v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
p= guarda a chave pública, encurtada aqui. Um p= vazio significa que a chave foi revogada. Para ler um registro real, use o Verificador DKIM.
Erros comuns
- Achar que DKIM aprovado significa DMARC aprovado. Um serviço pode assinar com o próprio domínio em
d=. A assinatura é válida, mas não se alinha com o domínio do seu From. Quando o serviço permitir, faça com que ele assine com o seu domínio. - Publicar a chave no nome errado. A Microsoft observa que a maioria dos provedores de DNS acrescenta o domínio ao nome do host automaticamente. Digitar o nome completo cria
brisbane._domainkey.exemplo.com.br.exemplo.com.br. Nesses provedores, informe sóbrisbane._domainkey. - Cortar uma chave longa. O Google avisa que uma chave de 2048 bits não entra como uma única string onde o limite é de 255 caracteres. Divida a chave em strings entre aspas no mesmo registro e mantenha um único registro TXT por seletor.
- Reaproveitar um seletor para uma chave nova. A RFC 6376 recomenda seletores novos para chaves novas. Publique a chave nova em um seletor novo, confirme-a no DNS e depois troque a chave de assinatura. Cuidado: mantenha a chave antiga no DNS até os e-mails assinados com ela chegarem ao destino. Se você a remover antes, esses e-mails podem falhar no DKIM. Se a sua política DMARC for
p=quarantineoup=reject, o destino pode mandá-los para o spam ou recusá-los, a menos que o SPF passe e esteja alinhado. - Alterar a mensagem depois da assinatura. Listas de discussão que marcam o assunto ou adicionam rodapé podem invalidar a assinatura, como explica a RFC 6377. Uma mudança no corpo aparece como body hash did not verify.