Pular para o conteúdo
DMARC Pulse

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.

Um nome à sua escolha. Ele passa a fazer parte do nome do registro.

Tamanho da chave

As chaves são criadas no seu navegador. A chave privada não é enviada ao nosso servidor.

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.

Passo 1: chave privada
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out selector.private.pem
Passo 2: valor TXT
printf 'v=DKIM1; k=rsa; p=%s\n' "$(openssl pkey -in selector.private.pem -pubout -outform DER | openssl base64 -A)"
Opcional: valor TXT dividido em strings entre aspas
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 ' ' -
Host / nomeTXT
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?
Informe o domínio e um seletor acima e clique no botão. Seu navegador cria um par de chaves RSA, e a página mostra o registro TXT para publicar e a chave privada para instalar no servidor de e-mail. Os comandos openssl desta página fazem o mesmo pela linha de comando.
É seguro gerar uma chave DKIM aqui?
O par de chaves é criado pela Web Crypto API do seu navegador e a chave privada fica na página: ela não é enviada em formulário, em URL nem em evento de analytics. Se a sua política de segurança exige chaves criadas nos seus próprios servidores, use os comandos openssl.
Devo escolher 2048 ou 1024 bits?
2048 bits. A RFC 8301 exige que quem assina use pelo menos 1024 bits e recomenda pelo menos 2048, e quem recebe precisa aceitar chaves de 1024 a 4096 bits. Fique com 1024 só se o seu provedor de DNS não conseguir publicar o registro mais longo.
O que usar como seletor?
Qualquer nome com letras, números, hifens e pontos, como 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?
Em geral porque um registro de 2048 bits passa dos 255 caracteres permitidos em uma string TXT. Cole a versão dividida em strings entre aspas. Confira também o nome: se o painel acrescenta o domínio sozinho, o host é só selector._domainkey.
Como saber se funcionou?
Depois de publicar o registro, use o Verificador DKIM com o mesmo domínio e seletor para confirmar que a chave está visível e válida. Em seguida, envie uma mensagem de teste e procure 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