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.

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
- Por que rotação segura é publicar, não substituir
- Os sete movimentos, na ordem que evita janela sem assinatura
- O cPanel só opera o seletor default, e isso muda seu plano
- Confirmar com dig que os dois seletores respondem
- Trocar o assinador e achar quem ainda usa o seletor antigo
- Onde ler a tag s= e o Authentication-Results
- Quanto tempo manter os dois e quando remover o antigo
- Frase pronta para avisar o cliente sobre a troca
- 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.
- Inventariar o estado atual: qual seletor está ativo, qual o tamanho da chave, qual a política DMARC.
- Reduzir o TTL do registro
_domainkey(por exemplo, de 24 horas para 300 segundos) e esperar o TTL antigo expirar antes de seguir. - Gerar o par novo no assinador que vai usar a chave (o seletor novo nasce junto com a chave privada).
- Publicar o TXT do seletor novo na zona, sem tocar no registro do seletor antigo.
- Confirmar por consulta pública que a zona responde pelos dois nomes.
- 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 oAuthentication-Resultsdizdkim=pass. - 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
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:
- Chave nova gerada fora e publicada manualmente. Você gera o par (por exemplo,
openssl genrsa -out s2.key 2048e extrai a pública), publica o TXT comos2._domainkeyno provedor de DNS e configura o assinador para usar essa chave privada. O registrodefault._domainkeysegue intacto. - WHM / configuração do Exim. Em servidor com acesso root, o assinador é configurado no nível do Exim, onde o nome do seletor e o caminho da chave privada são seus. É a rota que permite trocar o seletor sem passar pelo botão do painel.
- Assinador externo. Se quem assina é um relay (Google Workspace, Microsoft 365, serviço de envio transacional), o seletor é definido lá e o cPanel não participa da rotação, só não pode reassinar por cima.
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.
- Exim no servidor (WHM). Em *Exim Configuration Manager* você define o seletor e o caminho da chave privada usados na assinatura de saída; reinicie o Exim e envie um teste. Sem acesso root, essa rota depende do provedor.
- Email Deliverability do cPanel. Serve para manter o
defaultválido, não para apontar a outro seletor. Se você rotacionou por aqui, o que aconteceu foi troca de chave sob o mesmo nome. - Plugin SMTP do WordPress. Se o site envia por SMTP autenticado de uma caixa do domínio, quem assina é o servidor de saída, e nada muda no plugin. Se envia por API de terceiro (SendGrid, Brevo, Amazon SES), a assinatura é do serviço: troque o seletor no painel dele.
- Relay de marketing ou transacional. Cada serviço publica o seu próprio seletor; a rotação é feita lá dentro e pode exigir novo CNAME ou TXT na zona.
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.
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
- Dois provedores de DNS para o mesmo domínio. Delegação apontando para um conjunto de nameservers e você editando outro. Confira a delegação com
dig NS exemplo.com.br +shortantes de culpar o painel. - DMARC em
p=rejectcom alinhamento estrito (adkim=s). Se od=da assinatura não bater exatamente com o domínio doFrom:, passa no DKIM e falha no DMARC. Em rotação isso aparece quando o seletor novo é criado sob um subdomínio. - Encaminhamento. Mensagem encaminhada preserva a assinatura DKIM se o corpo e os cabeçalhos assinados não forem alterados. Um encaminhador que reescreve assunto quebra a assinatura, e isso não é culpa da rotação. Teste direto, não via encaminhamento.
- Cache do próprio painel. A verificação interna de entregabilidade pode levar minutos para refletir o DNS externo. A verdade está na consulta pública, não no indicador do painel.
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
- Documentação oficial (cpanel) — cPanel: documentação marcada como DKIM. Consultado em 2026-11-03.