Aprender
Como configurar DKIM: chave, registro DNS e primeiro teste
Como configurar DKIM: crie a chave e o seletor, publique o registro no DNS, ative a assinatura depois e confirme dkim=pass em um e-mail de teste.
Antes de começar
Como configurar DKIM: crie um par de chaves com um seletor, publique a chave pública no DNS do domínio e ative a assinatura no serviço que envia seu e-mail. O DKIM (DomainKeys Identified Mail) adiciona uma assinatura digital a cada mensagem, e quem recebe confere essa assinatura com a chave pública no DNS. O seletor é o rótulo de uma chave, e um domínio pode ter várias. Cada chave fica em seletor._domainkey.seudominio.
Você precisa de acesso ao DNS e de acesso de administrador em cada serviço que envia e-mail com o seu domínio no campo From.
O que você publica depende de quem assina o e-mail:
| Envio a partir de | Quem cria a chave | O que publicar |
|---|---|---|
| Google Workspace | O Admin Console | Um registro TXT, por padrão em google._domainkey |
| Microsoft 365 | A Microsoft | Dois registros CNAME, selector1._domainkey e selector2._domainkey |
| Amazon SES com Easy DKIM | O Amazon SES | Três registros CNAME mostrados no console |
| Seu próprio servidor de e-mail | Você | Um registro TXT para o seletor escolhido |
Um CNAME aponta o nome para um host do serviço, onde a chave fica publicada.
Passo a passo
-
Defina o tamanho da chave e o seletor. Escolha 2048 bits se o seu DNS aceitar. Em servidor próprio, use um seletor simples, como
mail1. Use um seletor novo por chave, para nunca sobrescrever uma chave que assinou e-mail ainda em trânsito. -
Crie a chave ou copie os registros. No Google Workspace, vá em Apps, Google Workspace, Gmail, depois Autenticar e-mails, e gere um novo registro. No Microsoft 365, abra a guia DKIM em Configurações de autenticação de email, no portal do Defender, e tente ativar o domínio. A caixa de erro é esperada. Depois, os detalhes do domínio mostram os valores em Publicar CNAMEs. No Amazon SES, crie a identidade de domínio e copie os registros em Publish DNS records. Em servidor próprio, gere o par com o gerador de DKIM e mantenha a chave privada no sistema que assina. Veja também DKIM no Google Workspace e DKIM no Microsoft 365.
-
Publique o registro no seu DNS. Em uma chave TXT, o nome é o seletor seguido de
._domainkey, e o valor segue este formato:TXTv=DKIM1; k=rsa; p=SUA_CHAVE_PUBLICA
Em registros CNAME, copie o destino como aparece e o nome sem o domínio, se o painel o acrescentar (veja abaixo).
-
Espere o registro aparecer. O Google fala em até 48 horas depois de adicionar a chave, e o Amazon SES prevê até 72 horas para mudanças no DNS. Faça a consulta da seção Confirme que funcionou antes de continuar.
-
Só depois disso, ative a assinatura. Se a mensagem sair assinada e quem recebe não encontrar a chave, a assinatura falha de forma permanente. Com
p=quarantineoup=rejectno registro DMARC, esse e-mail pode ir para quarentena ou ser rejeitado, a menos que o SPF passe e esteja alinhado. No Google Workspace, clique em Iniciar autenticação. No Microsoft 365, selecione Assinar mensagens para este domínio com assinaturas DKIM, que só tem efeito depois que a Microsoft detecta os registros CNAME. O Amazon SES conclui sozinho quando detecta os registros. Em servidor próprio, informe ao software de assinatura a chave privada, o domínio e o seletor. -
Repita para cada serviço e domínio. Dê a cada serviço um seletor próprio. O Google exige uma chave única para cada domínio.
Como adicionar o registro DKIM no DNS
Mantenha o sublinhado no nome. Alguns painéis acrescentam o domínio sozinhos. Neles, omita-o, também nos CNAME, e digite só a parte anterior, como mail1._domainkey ou selector1._domainkey.
Após p=, cole a chave pública, sem as linhas BEGIN e END e sem quebras de linha. Uma chave de 2048 bits não cabe em uma única string de 255 caracteres. Se o painel não aceitar o valor inteiro de uma vez, o Google orienta dividi-la em várias strings entre aspas no mesmo registro, e a RFC 6376 manda quem recebe juntá-las sem espaços.
Confirme que funcionou
-
Consulte o registro com seu seletor e seu domínio. Com CNAME, use
-type=CNAME.nslookup -type=TXT google._domainkey.exemplo.com.br 1.1.1.1O verificador de DKIM também lê a chave e o tamanho dela.
-
Envie um teste para alguém no Gmail ou Google Workspace. Segundo o Google, enviar para você mesmo não comprova o DKIM.
-
Na caixa do destinatário, abra o cabeçalho completo. No Gmail, ao lado de Responder, clique em Mais e em Mostrar original. Cole-o no analisador de cabeçalhos.
-
Procure
Authentication-Resultse veja se hádkim=pass. O formato muda conforme quem recebe, e alguns mostramDKIM=OK. -
Confira o domínio em
header.d=, ou na tagd=doDKIM-Signaturese só aparecerheader.i=. Para o DMARC, ele precisa estar alinhado com o domínio do From: o mesmo domínio organizacional por padrão, ou idêntico comadkim=s.
Erros comuns
- Registro TXT onde o serviço espera CNAME. O Microsoft 365 só aceita registros CNAME para DKIM. Um TXT em
selector1._domainkeydeixa o status emCnameMissing. - Assinatura válida com o domínio do serviço. A Microsoft observa que muitos serviços hospedados assinam com o domínio do serviço e só acrescentam o seu domínio depois que você configura o DKIM. Para o DMARC, só conta a assinatura alinhada com o From.
- Apagar a chave antiga cedo demais. A RFC 6376 descreve manter as duas chaves públicas publicadas durante a transição, enquanto pode haver e-mail assinado com a antiga ainda em trânsito. Apagar antes causa falhas de DKIM.