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

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

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

---

## 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 o `Authentication-Results` diz `dkim=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.

```bash
# 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](https://docs.cpanel.net/tags/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 2048` e extrai a pública), publica o TXT como `s2._domainkey` no provedor de DNS e configura o assinador para usar essa chave privada. O registro `default._domainkey` segue 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.

```bash
# 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 `default` vá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 header.i=@exemplo.com.br 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:

> **** Vamos trocar a assinatura digital dos e-mails do seu domínio para uma chave mais forte. Durante alguns dias as duas assinaturas, a antiga e a nova, ficam válidas ao mesmo tempo, então nenhum e-mail deixa de ser aceito. Depois desse período removemos a antiga. Não é preciso fazer nada do seu lado, e nenhum endereço ou senha muda.

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 +short` antes de culpar o painel.
- **DMARC em `p=reject` com alinhamento estrito (`adkim=s`).** Se o `d=` da assinatura não bater exatamente com o domínio do `From:`, 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](https://docs.cpanel.net/tags/dkim/), e os cabeçalhos mostrados são exemplos fictícios para orientar a leitura dos reais.

