Gerador de registro DKIM
DKIM Record Generator: gerar chave e registro DKIM
Informe o domínio e um seletor. Seu navegador gera o par de chaves, e esta página mostra o registro TXT para publicar e a chave privada para o seu servidor de e-mail.
Este navegador não conseguiu gerar a chave
Seu registro DKIM
Crie no seu provedor de DNS um registro TXT com este nome e este valor. Alguns painéis acrescentam o domínio sozinhos: neles, informe só a parte que vem antes.
Este registro é longo demais para uma única string de DNS
Sua chave privada
Instale no sistema que assina os e-mails que você envia, com o mesmo domínio e seletor.
Mantenha esta chave privada em segredo
Depois de publicar
Alterações de DNS levam de minutos a algumas horas para aparecer, conforme o TTL. Depois, confirme que a chave pública está visível e válida.
Gerar a chave com openssl
No Linux, macOS ou WSL, estes comandos dão o mesmo resultado na sua própria máquina: uma chave privada PEM e o valor TXT para publicar.
Troque selector e example.com pelos seus valores, ou preencha o formulário acima e envie.
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out selector.private.pem
printf 'v=DKIM1; k=rsa; p=%s\n' "$(openssl pkey -in selector.private.pem -pubout -outform DER | openssl base64 -A)"
printf 'v=DKIM1; k=rsa; p=%s' "$(openssl pkey -in selector.private.pem -pubout -outform DER | openssl base64 -A)" | fold -w 255 | sed 's/.*/"&"/' | paste -sd ' ' -
selector._domainkey.example.com
O que fazer com o resultado
Seu registro está pronto, em dois formatos
Com 2048 bits, o resultado mostra um nome de host e o mesmo valor em dois formatos. Publique apenas um deles, como um único registro TXT em mail1._domainkey.exemplo.com.br. Faça isso no provedor de DNS para onde apontam os registros NS do domínio, que pode ser diferente do registrador.
Não crie um registro para cada formato. A RFC 6376 §3.6.2.2 exige um único registro TXT por seletor e deixa qualquer outro caso indefinido. Se o seletor já tiver uma chave em uso, comece de novo com outro seletor. Ao substituir esse registro, os e-mails assinados com a chave antiga deixam de passar na verificação.
A chave privada está na sua tela
Esta chave assina seus e-mails e só existe nesta aba do navegador. Clique em Baixar .pem antes de sair e leve o arquivo ao sistema que assina. Deixe-o legível só para o serviço de assinatura. Por padrão, o OpenDKIM recusa arquivos de chave que outros usuários possam ler ou alterar. Se perder a chave antes de assinar, gere outro par e substitua o registro.
Ative a assinatura só depois que o registro TXT responder no DNS. Uma assinatura sem chave no DNS falha de forma permanente. Com p=quarantine ou p=reject, esses e-mails podem cair no spam ou ser rejeitados, a menos que o SPF passe para o domínio do From.
Você escolheu 1024 bits e a página mostra um aviso
Sua chave atende ao mínimo da RFC 8301, mas fica abaixo dos 2048 bits que ela recomenda. O Gmail aceita 1024 bits para contas pessoais e também recomenda 2048. O valor cabe em uma única string, por isso a página mostra só uma versão. O Verificador DKIM vai marcar esse tamanho com um alerta.
Trate esta chave como provisória. Quando seu provedor de DNS conseguir guardar o registro mais longo, gere um par de 2048 bits com um novo seletor e publique. Depois, troque a chave no sistema que assina. Mantenha o registro antigo por um tempo, porque e-mails assinados com a chave antiga ainda podem estar a caminho.
O navegador não criou a chave, ou o JavaScript está desativado
A página cria as chaves com o Web Crypto, um recurso do navegador que depende de JavaScript. Quando isso falha, você recebe comandos openssl para Linux, macOS ou WSL. Execute-os na ordem, no sistema que vai assinar, e mantenha o arquivo .pem lá.
Confira os nomes antes de publicar. Os comandos só trazem o seu seletor depois que o formulário chega ao servidor, o que não acontece se o Web Crypto começou e falhou. Se aparecer o nome genérico selector, como em selector.private.pem, troque-o pelo seu seletor em todos os comandos. O nome do host, o arquivo da chave e a configuração da assinatura precisam usar o mesmo seletor. Publique a saída do Passo 2, ou a versão dividida se o seu painel de DNS exigir strings entre aspas.
Você publicou o registro e quer confirmar
Use o Verificador DKIM com o mesmo domínio e seletor. Se ele não achar a chave, espere o DNS atualizar e procure um seletor digitado errado ou um nome duplicado, como mail1._domainkey.exemplo.com.br.exemplo.com.br. Se a chave aparecer como ilegível, o valor pode ter sido cortado: publique a versão dividida.
Com a chave lida corretamente, cole os cabeçalhos de um e-mail de teste no Analisador de Cabeçalho. O domínio em d= precisa estar alinhado com o domínio do From: por padrão, o mesmo domínio organizacional. Se não houver DMARC, crie um único registro com p=none e endereço rua=. Caso contrário, acrescente relatórios ao registro existente e preserve sua política. Acompanhe até cada remetente legítimo passar. Só então avance para p=quarantine ou p=reject.
Entenda
O que o gerador cria
Um par de chaves DKIM tem duas metades. A chave privada fica no sistema que envia seus e-mails e assina cada mensagem. A chave pública vai para o DNS, em um registro TXT em <seletor>._domainkey.<domínio>, onde quem recebe a busca para conferir a assinatura (RFC 6376).
Como publicar um registro longo
Uma string de um registro TXT tem no máximo 255 caracteres (RFC 1035). Um registro DKIM de 2048 bits tem cerca de 410, então precisa ser guardado em duas ou mais strings, escritas entre aspas uma depois da outra. Quem recebe junta as strings sem espaços entre elas (RFC 6376), então a divisão não altera a chave. Alguns painéis de DNS dividem valores longos sozinhos; nos demais, cole a versão dividida que esta página mostra.
Onde colocar a chave privada
Configure a chave no que assina os e-mails que você envia, como o OpenDKIM no seu próprio servidor, e restrinja quem pode ler o arquivo. Use nele o mesmo domínio e seletor: eles viram o d= e o s= de cada assinatura.
Serviços hospedados como Google Workspace ou Microsoft 365 costumam criar as chaves para você e informar os registros a publicar. Nesse caso, siga a configuração de DKIM do próprio serviço.
Perguntas frequentes
Como gerar uma chave DKIM?
É seguro gerar uma chave DKIM aqui?
Devo escolher 2048 ou 1024 bits?
O que usar como seletor?
mail1. Com seletores, um domínio mantém várias chaves ao mesmo tempo, e é assim que se faz a troca: publique a nova chave em um novo seletor, passe a assinar com ela e remova o registro antigo depois.Por que meu painel de DNS rejeita o registro?
selector._domainkey.Como saber se funcionou?
dkim=pass no cabeçalho Authentication-Results.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.
Ferramentas relacionadas