# Rollover de KSK em 5 etapas sem derrubar o domínio

Rollover de KSK por RRset duplo (duas KSK e dois DS em paralelo) com a consulta de verificação exata em cada etapa, a janela de espera derivada do TTL real do DS no pai e o caminho de reversão quando o DS novo não valida.

> a troca da KSK só é segura com duas KSK e dois DS em paralelo: adicione a nova DNSKEY, publique o DS novo no Registro.br mantendo o antigo, espere pelo menos o TTL do DS medido com dig @a.dns.br, confirme com delv, e só então remova a chave antiga.

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

---

Trocar a KSK de um domínio que já está assinado e resolvendo é diferente de ativar DNSSEC pela primeira vez. Na ativação, o pior caso é o domínio continuar sem validação. Aqui, o pior caso é `SERVFAIL` em todo resolvedor validante: se o DS publicado na zona pai apontar para uma DNSKEY que não existe mais no conjunto, o domínio deixa de resolver para quem valida, e isso inclui o 8.8.8.8 e o 1.1.1.1.

O método seguro aqui é manter as duas KSKs no DNSKEY RRset e os dois DS no pai ao mesmo tempo, removendo a chave antiga só no fim. A sequência deste guia mantém RRset duplo dos dois lados: a chave nova entra na zona e o DS novo entra no pai, cada um convivendo com o antigo até o último passo. Existe a ordem inversa, em que o DS da chave nova é publicado no pai *antes* de a chave existir na zona e só depois o conjunto de chaves é trocado: ali a espera crítica acontece no começo, não no fim. Este guia não usa essa ordem. Toda a tensão do procedimento está em uma única decisão: **quando é seguro remover a DNSKEY antiga**.

## Por que o rollover quebra na remoção e nunca na adição

Adicionar uma DNSKEY ao conjunto é inócuo. O resolvedor valida o DNSKEY RRset contra qualquer DS publicado no pai que corresponda a uma das chaves; chave extra sem DS correspondente é ignorada. Publicar DS extra no pai também é inócuo, desde que pelo menos um DS continue casando com uma DNSKEY presente e com a assinatura (RRSIG) do DNSKEY RRset.

A falha acontece no instante em que nenhuma das duas pontas fecha:

| Estado | DNSKEY na zona | DS no pai | Resultado em resolvedor validante |
|---|---|---|---||
| Inicial | K1 | DS(K1) | Valida |
| DNSKEY duplo | K1 + K2 | DS(K1) | Valida (por K1) |
| DS duplo | K1 + K2 | DS(K1) + DS(K2) | Valida (por K1 ou K2) |
| Remoção prematura | K2 | DS(K1) em cache | **SERVFAIL** |
| Final | K2 | DS(K2) | Valida |

A linha "remoção prematura" é a que derruba o domínio. E repare que ela não depende do que está publicado agora na zona pai: depende do que ainda está **em cache** nos resolvedores do mundo. Um resolvedor que buscou o DS antes da atualização mantém DS(K1) pelo TTL do registro, e durante esse tempo exige uma DNSKEY K1 que você já apagou.

## A janela de espera é o TTL do DS no pai, não o TTL da sua zona

A janela mínima entre publicar o DS novo e remover a chave antiga é o **TTL do RRset DS na zona pai**, contado a partir do momento em que a alteração realmente apareceu nos servidores autoritativos do pai. Para `.br`, o pai é o conjunto de servidores do Registro.br (`a.dns.br`, `b.dns.br`, etc.), e quem define o TTL do DS é o registro, não você.

Não chute esse valor. Consulte:

```bash
# TTL do DS como servido pelo pai (resposta autoritativa, TTL sempre cheio)
dig @a.dns.br exemplo.com.br DS +norecurse

# TTL residual em um resolvedor público (decrescente, mostra o que ainda está em cache)
dig @8.8.8.8 exemplo.com.br DS
dig @1.1.1.1 exemplo.com.br DS
```

A primeira consulta devolve o TTL de origem. A segunda devolve quanto falta expirar naquele resolvedor específico. Some ao TTL do DS a latência de publicação do registro (o intervalo entre você salvar o DS no painel e o `dig @a.dns.br` refletir a mudança) e trate isso como piso, não como alvo. Esperar o dobro não custa nada; esperar de menos custa o domínio.

O TTL da sua própria DNSKEY importa em outro momento: ele define quanto tempo um resolvedor pode continuar usando o conjunto antigo de chaves depois que você adicionou a K2. É o que obriga a esperar também **depois de adicionar** a nova chave e antes de confiar que todo mundo já a enxerga.

## As cinco etapas do rollover, da geração da chave à remoção do DS

A sequência abaixo segue o procedimento de rotação documentado pela cPanel em [How to Rotate a DNSSEC Key](https://docs.cpanel.net/knowledge-base/dns/how-to-rotate-a-dnssec-key/): gerar a nova chave, ativá-la junto com a antiga, levar o novo DS ao registrador, esperar, e só então desativar e remover a chave antiga.

### Gerar a nova KSK e confirmar que ela ainda não está publicada

No WHM, em *Home » DNS Functions » DNSSEC Management* (caminho conforme a doc da cPanel citada), selecione a zona e gere uma nova chave. A doc da cPanel citada descreve a chave recém-gerada como inativa até que você a ative explicitamente, mas não confie nisso de cabeça: confirme com o `dig` abaixo que o DNSKEY RRset publicado ainda traz só a K1. Anote o **key tag** e o algoritmo: é por eles que você vai distinguir K1 de K2 em toda consulta daqui para frente.

Verificação: a zona ainda deve responder exatamente com a chave antiga.

```bash
dig @ns1.seudominio.com.br exemplo.com.br DNSKEY +dnssec +norecurse
```

### Ativar a K2 e verificar o DNSKEY RRset em todos os autoritativos

Ative a K2. Agora o DNSKEY RRset contém K1 e K2, e deve estar assinado de forma que a validação feche pela K1, que é a que tem DS no pai.

Verificação obrigatória antes de prosseguir, em **todos** os autoritativos da zona, um a um:

```bash
for ns in ns1.seudominio.com.br ns2.seudominio.com.br; do
  echo "== $ns"
  dig @$ns exemplo.com.br DNSKEY +dnssec +norecurse +multiline
done
```

Se um secundário ainda não transferiu a zona nova, pare aqui e resolva a replicação. Rollover com autoritativos divergindo no DNSKEY RRset produz validação intermitente, que é pior de diagnosticar que falha total.

### Publicar o DS da K2 no Registro.br sem remover o DS da K1

Copie o DS gerado para a K2 e cadastre-o no painel do domínio, **sem remover o DS da K1**. Os dois DS convivem: qualquer um deles fecha a cadeia.

Verificação direta no pai, ignorando cache:

```bash
dig @a.dns.br exemplo.com.br DS +norecurse +multiline
```

Você deve ver dois registros DS, com os dois key tags. Se só aparecer um, a alteração ainda não propagou para os autoritativos do `.br`.

### Esperar o TTL do DS e confirmar que a cadeia fecha pela chave nova

Espere o TTL do DS medido na etapa anterior, contado a partir do momento em que o `dig @a.dns.br` passou a mostrar os dois DS. Durante a espera, confirme que a validação está fechando de ponta a ponta:

```bash
# cadeia completa, com explicação de cada passo
delv exemplo.com.br A +rtrace

# flag AD em resolvedor validante
dig @1.1.1.1 exemplo.com.br A +dnssec

# mesma consulta ignorando a validação do resolvedor: compara a resposta crua
dig @1.1.1.1 exemplo.com.br A +cd
```

O que você quer ver: `fully validated` no `delv` e a flag `ad` presente no `dig`. Se a consulta com `+cd` responde e a sem `+cd` dá `SERVFAIL`, a cadeia está quebrada agora e remover qualquer chave vai piorar.

### Desativar a K1, confirmar a validação e só então apagar chave e DS

Desative a K1 primeiro, sem apagar. Confirme que a zona segue válida. Depois remova.

```bash
dig @ns1.seudominio.com.br exemplo.com.br DNSKEY +dnssec +norecurse
delv exemplo.com.br A +rtrace
```

Por último, remova o DS da K1 no painel do Registro.br. A ordem aqui é a inversa da etapa 3: a chave sai da zona antes do DS sair do pai, porque DS órfão por alguns minutos com outra chave válida presente não quebra nada, enquanto chave removida com DS exclusivo apontando para ela quebra tudo.

## Como reverter quando o DS novo não valida (e o que fazer se já removeu a K1)

Reverter é fácil enquanto a K1 ainda existe. Esse é o motivo de a chave antiga só ser apagada no último passo.

- **DS novo cadastrado com digest ou algoritmo errado**: remova apenas o DS da K2 no painel. A cadeia volta a fechar pela K1 assim que o pai propagar. A zona nunca fica sem cobertura.
- **`delv` acusa `no valid signature` depois da etapa 2**: o problema é assinatura, não DS. Desative a K2, confirme que o DNSKEY RRset voltou ao estado anterior e reassine antes de tentar de novo.
- **Já removeu a K1 e o domínio está em SERVFAIL**: reative a chave antiga imediatamente, se o backend ainda a tiver. Se não tiver, a única saída é remover **todos** os DS no Registro.br. Isso não é alívio imediato: quem já tem o DS antigo em cache continua em `SERVFAIL` até esse cache expirar, e a resolução só volta (sem validação, em texto puro) depois que o TTL do DS corre até o fim em cada resolvedor. Ou seja, você paga a janela inteira do TTL antes de ver recuperação. É degradação deliberada para recuperar disponibilidade. Documente e refaça a assinatura depois, com calma.

Guarde o material da K1 (incluindo o DS gerado) até o fim do rollover. É o seu botão de desfazer.

## Checklist de comando e resultado esperado em cada etapa

| Etapa | Comando | Resultado esperado |
|---|---|---||
| 1. Chave gerada | `dig @autoritativo DNSKEY +dnssec +norecurse` | Apenas o key tag antigo |
| 2. Chave ativada | mesmo comando, em cada autoritativo | Os dois key tags, iguais em todos |
| 3. DS publicado | `dig @a.dns.br DS +norecurse` | Dois registros DS |
| 4. Espera | `delv dominio A +rtrace` | `fully validated` |
| 4. Espera | `dig @1.1.1.1 dominio A +dnssec` | Flag `ad` na resposta |
| 5. Remoção | `delv` + `dig +cd` | Mesma resposta com e sem `+cd` |

O `+cd` (checking disabled) é o teste decisivo: ele manda o resolvedor devolver a resposta sem validar. Se com `+cd` vem resposta e sem `+cd` vem `SERVFAIL`, o problema é DNSSEC e não o conteúdo da zona.

## Quatro erros típicos de rollover e o que cada um indica

- **`SERVFAIL` em resolvedor validante, resposta normal com `+cd`**: cadeia quebrada. DS no cache aponta para chave ausente, ou RRSIG do DNSKEY não fecha.
- **Validação funciona em um resolvedor e falha em outro**: diferença de cache de DS. Normalmente significa que alguém removeu algo antes do TTL expirar. Reverta, não espere.
- **`delv` retorna `insecure`**: nenhum DS está sendo visto no pai. Verifique com `dig @a.dns.br DS` se o cadastro realmente existe.
- **DNSKEY difere entre primário e secundário**: a transferência de zona não ocorreu. Rollover parado até a replicação normalizar.

## Três condições para só então iniciar o rollover

Três condições que evitam quase todo incidente de rollover:

- Consulte o TTL do DS no pai **antes** de mexer em qualquer coisa, e planeje a janela a partir dele.
- Nunca execute as etapas 3 e 5 no mesmo dia por conveniência de agenda. A espera entre elas é o procedimento, não um atraso.
- Agende o rollover para o início de uma janela em que você esteja disponível pelas horas seguintes. Quebra de DNSSEC não aparece de imediato: ela aparece conforme caches expiram, de forma escalonada.

Se o domínio não está sob pressão de política de rotação, há uma recomendação que vale dizer: KSK não precisa ser trocada por calendário. Troque quando houver motivo (suspeita de comprometimento, mudança de algoritmo, migração de provedor de DNS). Rollover desnecessário é risco sem contrapartida.

