blog
Domínios e DNS

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.

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

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
  1. Por que a ordem invertida derruba mensagens que já saíram
  2. As cinco etapas da rotação, da inventariação à remoção
  3. Checklist de rotação para carteira com vários domínios
  4. Permerror, temperror e fail: o que cada resultado indica
  5. Aviso pronto para o cliente e quando a troca não se justifica
  6. 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:

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:

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.

Ordem obrigatória da rotação de chave DKIM1. InventariarSeletor atual e DNS autoritativo2. Publicar novoTXT do seletor novo na zona3. Trocar assinaturaMTA passa a assinar com novo4. Provar entregadkim=pass no Gmail e Outlook5. Remover antigoSó após prazo e teste final
A ordem não é preferência: publicar antes de remover é o que evita janela de falha.

Checklist de rotação para carteira com vários domínios

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
Lendo o resultado DKIM depois da trocadkim=permerrorConferir TXT nos dois resolvedoresdkim=temperrorResolução instável, não remover nadadkim=pass, seletor antigoServidor ainda não trocou a assinaturadkim=fail em alguns destinosMensagem alterada no caminhoSem DKIM-SignatureAssinatura inativa para o domínio
Leia o resultado no Authentication-Results antes de mexer na zona de novo.

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

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