blog
Domínios e DNS

Trocar a chave DKIM sem e-mail rejeitado

Rotação com dois seletores publicados simultaneamente, checklist repetível por domínio de cliente e como confirmar no cabeçalho qual chave assinou cada mensagem.

JR · · 9 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: publique um segundo seletor DKIM e mantenha os dois registros na zona ao mesmo tempo. Troque o assinador, confirme pela tag s= do DKIM-Signature e pelo Authentication-Results no Gmail e no Outlook, e só remova o seletor antigo depois de cumprir a janela de convivência.

Neste artigo
  1. Por que rotação segura é publicar, não substituir
  2. Os sete movimentos, na ordem que evita janela sem assinatura
  3. O cPanel só opera o seletor default, e isso muda seu plano
  4. Confirmar com dig que os dois seletores respondem
  5. Trocar o assinador e achar quem ainda usa o seletor antigo
  6. Onde ler a tag s= e o Authentication-Results
  7. Quanto tempo manter os dois e quando remover o antigo
  8. Frase pronta para avisar o cliente sobre a troca
  9. Delegação, alinhamento estrito e encaminhamento: o que ainda quebra

Por que rotação segura é publicar, não substituir

Você precisa trocar a chave DKIM de um domínio de cliente e não pode arriscar uma janela em que as mensagens saiam sem assinatura válida. Dois casos típicos: a chave antiga é de 1024 bits e você quer subir para 2048, ou a chave privada foi exposta (migração de servidor mal feita, backup público, acesso compartilhado).

A saída é não trocar nada. É publicar um segundo seletor e deixar os dois no DNS ao mesmo tempo. O DKIM foi desenhado para isso: o verificador lê a tag s= dentro do cabeçalho DKIM-Signature da mensagem e consulta exatamente aquele seletor em <seletor>._domainkey.<dominio>. Dois seletores publicados não brigam entre si, porque cada mensagem aponta para o seu.

O que não pode acontecer é o inverso: remover o registro antigo enquanto algum relay, fila ou cache ainda produz ou valida assinatura com ele. Daí vem a falha de DKIM e, com DMARC em p=reject, a rejeição.

Os sete movimentos, na ordem que evita janela sem assinatura

Esta é a sequência que você repete em cada domínio, na ordem. Antecipar um passo é o que produz janela sem assinatura válida.

  1. Inventariar o estado atual: qual seletor está ativo, qual o tamanho da chave, qual a política DMARC.
  2. Reduzir o TTL do registro _domainkey (por exemplo, de 24 horas para 300 segundos) e esperar o TTL antigo expirar antes de seguir.
  3. Gerar o par novo no assinador que vai usar a chave (o seletor novo nasce junto com a chave privada).
  4. Publicar o TXT do seletor novo na zona, sem tocar no registro do seletor antigo.
  5. Confirmar por consulta pública que a zona responde pelos dois nomes.
  6. Passar o assinador a usar o seletor novo e conferir, em mensagens reais recebidas no Gmail e no Outlook, que a tag s= mudou e que o Authentication-Results diz dkim=pass.
  7. Esperar a janela de convivência e só então remover o TXT do seletor antigo.

O que anotar por domínio antes de editar a zona

Se você administra DNS em provedores diferentes por cliente, o inventário é o que impede retrabalho. Anote por domínio: provedor de DNS, onde o e-mail é assinado, seletor atual, TTL do registro _domainkey e política DMARC. Um domínio com DMARC em p=none tolera um erro; um em p=reject não.

# seletor atual e chave publicada
dig +short TXT default._domainkey.exemplo.com.br

# politica DMARC em vigor
dig +short TXT _dmarc.exemplo.com.br
Rotação de chave DKIM na ordem seguraInventariarSeletor, DNS, DMARC por domínioBaixar TTLEsperar o TTL antigo expirarPublicar seletor novoSem tocar no registro antigoTrocar assinadorConferir s= no Gmail e OutlookRemover antigoSó após a janela de convivência
Ordem dos passos da rotação. Antecipar um deles é o que cria janela sem assinatura válida.

O cPanel só opera o seletor default, e isso muda seu plano

No cPanel, DKIM é tratado dentro de Email Deliverability (Email » Email Deliverability), que mostra por domínio o estado dos registros DKIM, SPF e PTR e oferece a ação de instalar ou reparar os registros sugeridos. A documentação oficial do cPanel sobre DKIM é a referência para a interface e para o comportamento da chave gerada pelo servidor.

O ponto que decide o seu plano: a interface opera sobre o seletor padrão (default) e não oferece campo para escolher o nome do seletor. Gerar ou reparar a chave ali substitui o valor publicado em default._domainkey. Isso é substituição, não convivência.

Convivência com dois seletores exige, portanto, uma destas rotas:

Quando o DNS está fora (Cloudflare, Registro.br com DNS de terceiro, painel da agência), o cPanel apenas mostra o registro que deveria existir, e toda publicação é manual no provedor externo. Esse é o cenário mais comum em agência e também o mais confortável para esta rotação: você controla os dois nomes de seletor na zona e decide quando cada um sai.

Confirmar com dig que os dois seletores respondem

Antes de trocar o assinador, a zona precisa responder. Consulta pública, não cache do seu navegador.

# seletor antigo: deve continuar respondendo
dig +short TXT s1._domainkey.exemplo.com.br @1.1.1.1

# seletor novo: deve responder com v=DKIM1; k=rsa; p=...
dig +short TXT s2._domainkey.exemplo.com.br @1.1.1.1

Se o valor vier quebrado em várias strings entre aspas, isso é normal: TXT tem limite de 255 caracteres por string e chaves de 2048 bits chegam divididas; as strings são concatenadas pelo verificador DKIM ao montar o registro. O que invalida é o provedor de DNS inserir espaço ou quebra dentro do valor de p=. Compare o conteúdo com o que o painel exibe, caractere a caractere, quando a verificação falhar.

Erros comuns nesta etapa:

Sintoma Causa provável Correção
dig não retorna nada para o seletor novo registro ainda propagando ou criado na zona errada conferir o nome completo e aguardar o TTL da zona
Nome vira s2._domainkey.exemplo.com.br.exemplo.com.br painel que já concatena o domínio cadastrar só s2._domainkey
Valor com p= truncado campo do provedor cortou o texto colado recolar usando o campo de TXT longo do provedor
Seletor antigo sumiu chave nova instalada sobre o mesmo seletor republicar o valor antigo e refazer com nome distinto

Trocar o assinador e achar quem ainda usa o seletor antigo

O TXT publicado não muda nada sozinho. Quem decide a tag s= é quem assina, e em site de cliente costuma haver mais de um assinador.

Depois de cada mudança, valide uma origem por vez: envie da origem alterada e confira a tag s= no cabeçalho recebido. Validar tudo de uma vez esconde qual caminho ficou para trás.

Onde ler a tag s= e o Authentication-Results

Depois de apontar o assinador para o seletor novo, envie uma mensagem real para uma caixa Gmail e outra Outlook e abra o original.

No Gmail: abrir a mensagem, menu de três pontos, Mostrar original. No Outlook na web: abrir a mensagem, menu de três pontos, Exibir » Exibir origem da mensagem.

Você procura duas coisas. A tag s= dentro de DKIM-Signature, que diz qual seletor assinou, e a linha Authentication-Results, que diz o veredito de quem recebeu.

(exemplo ficticio, apenas para ilustrar a leitura)
Authentication-Results: mx.google.com;
       dkim=pass [email protected] header.s=s2;
       spf=pass smtp.mailfrom=exemplo.com.br;
       dmarc=pass (p=REJECT) header.from=exemplo.com.br
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
       d=exemplo.com.br; s=s2; t=1760000000;

Leitura: s=s2 confirma que a mensagem saiu assinada pela chave nova, e dkim=pass com header.s=s2 confirma que o receptor conseguiu buscar o TXT e validar. Se aparecer s=s2 mas dkim=fail ou dkim=temperror, o problema é o registro publicado, não o assinador: volte para a consulta dig.

Enquanto algum caminho de envio ainda mostrar s=s1, existe um assinador que você não atualizou. Em site de cliente isso costuma ser um plugin de SMTP no WordPress, um formulário que envia por outro serviço, ou um relay de marketing. Todos precisam aparecer com o seletor novo antes da remoção.

Diagnóstico pelo cabeçalho recebidoLer cabeçalho da mensagem recebidas= ainda é o antigo?Existe assinador não atualizados= novo e dkim=passOrigem validada, siga para a próximas= novo e dkim=failProblema no TXT publicadoVolte ao dig do seletorCompare o valor de p= inteiro
Como interpretar a tag s= e o Authentication-Results em cada origem de envio, uma por vez.

Quanto tempo manter os dois e quando remover o antigo

A janela mínima não é um número universal: é derivada do TTL que estava publicado no registro antigo no momento em que você começou, porque é esse valor que os resolvedores guardaram em cache. Some a isso o tempo de drenagem de filas de retentativa dos receptores, que podem revalidar uma mensagem antiga.

Regra prática de agência, conservadora e fácil de defender para o cliente: mantenha os dois seletores por pelo menos 72 horas depois que todas as origens de envio passarem a mostrar s= com o seletor novo, e nunca remova nada em sexta-feira. Se a rotação é por chave vazada, reduza esse prazo com consciência do risco, mas só depois de confirmar em Gmail e Outlook.

Por isso o passo 2 existe: com o TTL do _domainkey reduzido antes de começar, o cache deixa de ser o fator dominante e a janela fica curta por construção, não por sorte.

Checklist de 11 etapas com evidência de cada uma

# Etapa Evidência de que passou
1 Inventário (seletor, DNS, DMARC) anotação no controle da agência
2 TTL do _domainkey reduzido dig mostra TTL baixo
3 Par novo gerado (fora do painel ou no WHM) valor TXT em mãos
4 TXT do seletor novo publicado dig responde v=DKIM1
5 TXT do seletor antigo intacto dig ainda responde
6 Assinador apontado ao seletor novo s= novo no Gmail
7 Validação cruzada dkim=pass no Gmail e no Outlook
8 Origens secundárias conferidas SMTP do site, formulários, marketing
9 Janela de convivência cumprida data e hora registradas
10 TXT antigo removido dig deixa de responder
11 Reteste pós-remoção dkim=pass mantido

Frase pronta para avisar o cliente sobre a troca

O cliente não precisa de DKIM explicado, precisa de risco e prazo. Frase pronta, para copiar:

Se a rotação for por suspeita de vazamento da chave, acrescente uma linha só: a chave antiga podia ser usada por terceiros para assinar mensagens em nome do domínio, e a troca encerra essa possibilidade.

Delegação, alinhamento estrito e encaminhamento: o que ainda quebra

Nenhum número deste artigo veio de medição nossa: a parte de interface e comportamento do DKIM no cPanel está na documentação oficial, e os cabeçalhos mostrados são exemplos fictícios para orientar a leitura dos reais.

Referências

  1. Documentação oficial (cpanel) — cPanel: documentação marcada como DKIM. Consultado em 2026-11-03.
Leia também