# 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.

> 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.

João Rizzon · 2026-11-06 · Domínios e DNS

---

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](https://docs.cpanel.net/tags/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](https://docs.cpanel.net/tags/dkim/) é 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](https://docs.cpanel.net/tags/dkim/) 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 `default` pela 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 header.i=@exemplo.com.br header.s=s2026a header.b=Qa91vK2x;
       spf=pass (google.com: domain of contato@exemplo.com.br designates ... as permitted sender) smtp.mailfrom=contato@exemplo.com.br;
       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=pass` com `header.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:

> **** Vamos substituir a chave de assinatura dos e-mails do seu domínio, que é o que prova aos provedores que as mensagens saíram mesmo de você. A chave nova entra antes de a antiga sair, justamente para que o envio e o recebimento sigam normais durante a troca, e vamos confirmar isso por teste. Depois de confirmarmos que as mensagens estão chegando normalmente no Gmail e no Outlook, removemos a chave antiga. Você não precisa fazer nada.

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.

