Trocar a chave DKIM sem parar o e-mail: a ordem certa
A rotação de DKIM tem ordem obrigatória: inventariar, publicar, assinar, provar pelo cabeçalho, esperar e remover. Inverter dois passos derruba a assinatura de mensagens que ainda estão em fila.

Resposta curta: publique o registro TXT do seletor novo antes de qualquer outra coisa, troque a assinatura do servidor, confirme por cabeçalho Authentication-Results de uma mensagem entregue no Gmail e no Outlook que o seletor novo deu dkim=pass, e só então remova o seletor antigo da zona.
Neste artigo
- Por que a ordem invertida derruba mensagens que já saíram
- As cinco etapas da rotação, da inventariação à remoção
- Checklist de rotação para carteira com vários domínios
- Permerror, temperror e fail: o que cada resultado indica
- Aviso pronto para o cliente e quando a troca não se justifica
- Datas e mudanças em que a rotação não deve acontecer
Trocar uma chave DKIM é uma das poucas tarefas de DNS em que a ordem dos passos não é estilo pessoal: ela é obrigatória. Publicar o registro novo antes de remover o antigo mantém tudo entregando. Fazer o inverso cria uma janela em que mensagens já assinadas saem com um seletor que o verificador não encontra mais na zona, e a assinatura passa de PASS para falha permanente.
Este guia é documental. Os parâmetros e nomes de interface vêm da documentação oficial do cPanel sobre DKIM (consultada em 03/11/2026). Os seletores, domínios e cabeçalhos mostrados são exemplos fictícios, úteis para você reconhecer o formato, não medições nossas.
Por que a ordem invertida derruba mensagens que já saíram
A assinatura DKIM viaja dentro da mensagem. O cabeçalho DKIM-Signature carrega dois campos que importam aqui: d= (o domínio) e s= (o seletor). Quem recebe lê esses dois campos, monta o nome s._domainkey.d e consulta o DNS para buscar a chave pública.
Isso significa que a validação acontece no momento da leitura, não no momento do envio. Uma mensagem assinada hoje de manhã e que fique em fila de retry do destinatário até a noite vai ser verificada contra o DNS da noite. Se você apagou o seletor antigo no meio do caminho, a consulta volta vazia e o resultado vira dkim=permerror ou dkim=fail, dependendo do verificador.
Três categorias de mensagem são atingidas quando a ordem é invertida:
- mensagens na fila de saída do seu servidor, já assinadas, ainda não entregues;
- mensagens aceitas pelo destino mas em fila interna (greylisting, retry por 4xx, filtro em backlog);
- mensagens antigas revalidadas por sistemas que reavaliam reputação, inclusive encaminhamentos via listas e aliases.
Nenhuma dessas você controla depois que o e-mail saiu. Por isso a regra: o seletor antigo só sai da zona depois que nenhuma mensagem viva lá fora depende dele.
As cinco etapas da rotação, da inventariação à remoção
| Etapa | O que fazer | Como saber que terminou |
|---|---|---|
| 1 | Inventariar o seletor em uso e onde o DNS é autoritativo | Você sabe o valor de s= atual e em qual provedor edita a zona |
| 2 | Publicar o registro TXT do seletor novo | Consulta DNS externa devolve a chave nova |
| 3 | Trocar a assinatura do servidor para o seletor novo | Mensagem de teste sai com s= novo |
| 4 | Provar entrega real no Gmail e no Outlook | Authentication-Results mostra dkim=pass com o seletor novo |
| 5 | Esperar a convivência e só então remover o antigo | Nenhuma mensagem nova usa o seletor antigo há tempo suficiente |
Se você gerencia dez, trinta sites de clientes, trate isso como rotina de carteira: etapas 1 e 2 em lote num dia, etapa 5 em lote semanas depois, com uma planilha simples de seletor antigo, seletor novo e data de publicação.
Como descobrir o seletor em uso lendo o cabeçalho de uma mensagem real
O jeito mais confiável é abrir uma mensagem já enviada pelo domínio e ler o cabeçalho. No Gmail, Mostrar original. No Outlook web, Detalhes da mensagem. Procure a linha DKIM-Signature e o campo s=.
Exemplo de cabeçalho (fictício):
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=exemplo.com.br; s=default; t=1762100000;
bh=47DEQpj8HBSa+/TImW+5JCeuQeR...;
h=From:To:Subject:Date:Message-ID;
b=Hk3v9s...
Aqui o seletor em uso é default. Confirme que ele realmente existe na zona:
dig +short TXT default._domainkey.exemplo.com.br
Se vier vazio e mesmo assim as mensagens passam, muito provavelmente o DNS autoritativo não é o que você está olhando. Resolva isso antes de qualquer outra coisa: rotacionar chave com zona errada é o erro mais caro dessa tarefa.
Publicar o seletor novo e por que o cPanel só gerencia o seletor default
No cPanel, a área de e-mail traz a gestão de DKIM e a geração da chave; a documentação oficial é a referência para a interface da sua versão, que muda de release para release. Em ambiente com DNS externo (Cloudflare, Registro.br, provedor do cliente), o cPanel mostra o valor que deveria estar publicado e você copia o TXT para a zona autoritativa.
Nomeie o seletor novo de forma que o próximo você entenda: s2026a, nap2026, mail2026. Dois nomes distintos convivendo é o que torna a rotação sem janela possível.
Aqui entra a limitação que decide o resto do procedimento: a gestão nativa de DKIM do cPanel trabalha com o seletor default e oferece gerar ou regenerar a chave desse seletor, não escolher o nome do seletor pela interface (veja a documentação oficial do cPanel para a sua versão). Com seletor fixo, regenerar substitui a chave sob o mesmo nome: o valor antigo deixa de existir no instante em que o novo é publicado, que é exatamente a janela que este guia evita.
Daí os dois caminhos possíveis:
- Seletor próprio, que é o que permite a convivência: exige configurar a assinatura no MTA do servidor com o nome novo e publicar o TXT correspondente na zona autoritativa. Em servidor gerenciado, isso se pede ao suporte do provedor de hospedagem; em VPS que você administra, é configuração sua no MTA.
- Seletor
defaultpela interface, quando não há acesso ao MTA nem suporte disponível: regenere com a fila de saída vazia e fora de horário de pico, e assuma que mensagens já em trânsito assinadas com a chave antiga podem falhar na verificação. Nesse caminho não existe convivência, só escolha de hora.
Valide de fora antes de seguir:
dig +short TXT s2026a._domainkey.exemplo.com.br @8.8.8.8
dig +short TXT s2026a._domainkey.exemplo.com.br @1.1.1.1
Os dois precisam devolver a chave. Se um devolve e o outro não, é propagação em curso ou cache antigo do nome; espere e repita.
Apontar a assinatura do servidor para o seletor novo
Só depois que o TXT novo responde em resolvedores públicos você aponta o servidor para assinar com ele. Até esse momento, as mensagens continuam saindo com o seletor antigo, e está tudo certo: o antigo ainda está publicado. Na prática, essa etapa é a configuração de assinatura do MTA com o seletor novo, feita por você no VPS ou solicitada ao suporte do provedor. Se você ficou no caminho do seletor default, não há o que apontar: a regeneração da chave no painel já é a etapa 3, e as etapas 4 e 5 viram, respectivamente, prova por cabeçalho e verificação de que nada ficou falhando.
Provar dkim=pass com o seletor novo no Gmail e no Outlook
Ferramenta de teste online é útil, mas o que vale como prova é um cabeçalho de mensagem que chegou na caixa do Gmail e na do Outlook. Mande uma de cada, abra e leia Authentication-Results.
Exemplo de cabeçalho de uma mensagem entregue no Gmail (fictício):
Authentication-Results: mx.google.com;
dkim=pass [email protected] header.s=s2026a header.b=Qa91vK2x;
spf=pass (google.com: domain of [email protected] designates ... as permitted sender) [email protected];
dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=exemplo.com.br
O que você precisa ver, nessa ordem: dkim=pass, e header.s= com o seletor novo. Se aparecer dkim=pass mas com o seletor antigo, o servidor ainda não trocou a assinatura; volte à etapa 3. Se aparecer dkim=neutral ou dkim=permerror, o TXT novo está incompleto (quebra de linha indevida, aspas sobrando, valor truncado pelo painel de DNS).
No Outlook, procure a mesma linha Authentication-Results nos detalhes da mensagem. O formato muda, o conteúdo útil é o mesmo: resultado DKIM e seletor.
Quanto tempo manter os dois seletores e quando apagar o antigo
Antes de começar a rotação, de preferência na véspera, baixe o TTL do TXT do seletor antigo (de 3600 para 300 segundos, por exemplo) e anote o valor original na planilha para restaurar depois. Isso encurta a janela de cache que você vai ter que esperar no fim, e dá para fazer em lote na carteira inteira. Durante a convivência, mantenha os dois TXT publicados. Não há pressa nenhuma para apagar o antigo: um registro TXT a mais na zona não custa nada e não confunde verificador, porque a busca é sempre pelo nome exato que vem no s=.
O critério para remover não é o calendário, é a soma de três tempos: o TTL do registro antigo (o cache pode guardar, mas também pode já ter expirado), o tempo máximo de retry das filas que podem conter mensagens suas, e a sua margem de segurança. Escolha um prazo folgado e anote a data na planilha da carteira. Antes de apagar, confirme que nenhuma mensagem recente ainda sai com o seletor velho: envie uma mensagem de teste, leia o s=, e só então remova.
Checklist de rotação para carteira com vários domínios
- [ ] Seletor atual identificado por cabeçalho de mensagem real, não por suposição
- [ ] DNS autoritativo confirmado (quem responde de verdade pelo domínio)
- [ ] TTL do TXT do seletor antigo reduzido antes da troca, com o valor original anotado
- [ ] Seletor novo escolhido com nome datado
- [ ] TXT novo publicado e respondendo em dois resolvedores públicos
- [ ] Assinatura do servidor apontando para o seletor novo
- [ ]
dkim=passcomheader.s=novo confirmado no Gmail - [ ] Mesmo resultado confirmado no Outlook
- [ ] Data de publicação registrada e data de remoção agendada
- [ ] Seletor antigo removido só após o prazo, com teste final antes
Permerror, temperror e fail: o que cada resultado indica
| Sintoma | Causa provável | O que fazer |
|---|---|---|
dkim=permerror logo após a troca |
Seletor novo ainda não resolve, ou valor TXT truncado | Conferir com dig nos dois resolvedores e recolar o valor inteiro |
dkim=temperror intermitente |
Falha transitória de resolução DNS no verificador (timeout, autoritativo lento) | Diferente de permerror: o registro existe. Reenviar, conferir resposta e tempo dos NS, e não remover nada enquanto aparecer |
dkim=fail só em alguns destinos |
Modificação da mensagem no caminho (lista, encaminhamento, rodapé injetado) | Não é a rotação; investigar separadamente |
dkim=pass com seletor antigo |
Servidor ainda assina com o antigo | Concluir a etapa 3 antes de pensar em remover |
Nenhum DKIM-Signature no cabeçalho |
A assinatura não está ativa para esse domínio no servidor | Revisar a configuração de DKIM do domínio |
| Zona editada e nada muda | DNS autoritativo é outro | Corrigir onde você edita, não o que você edita |
Aviso pronto para o cliente e quando a troca não se justifica
Quando precisar avisar, use algo curto e sem jargão. Copie e cole:
Se o cliente perguntar por que trocar, a resposta honesta costuma ser uma destas: a chave atual é curta demais, a chave pode ter sido exposta em uma migração, ou é higiene periódica da mesma natureza de trocar senha de serviço. Se nenhuma das três se aplica e o DKIM está passando, rotacionar não resolve problema de entregabilidade por si só. Nesse caso, diga isso ao cliente em vez de vender a tarefa: olhar DMARC, reputação de IP e conteúdo da mensagem costuma render mais.
Datas e mudanças em que a rotação não deve acontecer
Não faça a troca na véspera de um disparo grande, nem no mesmo dia em que você mexe em SPF, MX ou troca de servidor. Cada mudança precisa ser isolável, porque se a entrega cair você vai querer saber qual delas foi. E não rotacione em dez domínios de uma vez sem ter validado o procedimento em um. A etapa 4, a prova por cabeçalho real, é o que transforma esse trabalho em rotina segura; pular ela é o que transforma em plantão de madrugada.
Referências
- Documentação oficial (cpanel) — cPanel: documentação marcada como DKIM. Consultado em 2026-11-03.