# Remova o DS antes de migrar: DNSSEC e troca de nameserver

Como inventariar quais domínios da carteira têm zona assinada, cruzar com o DS publicado no registrador e executar a troca na ordem que não derruba o site.

> sim, remova o registro DS no registrador antes de trocar de nameserver e espere o TTL do DS expirar. Com o DS apontando para uma chave que não existe mais no servidor novo, resolvedores validantes devolvem SERVFAIL e o site some para parte dos visitantes, sem erro visível no DNS público.

João Rizzon · 2026-10-22 · Domínios e DNS

---

Migração de hospedagem que dá errado costuma dar errado de forma barulhenta: site fora, erro de certificado, banco não conecta. O domínio assinado com DNSSEC falha de um jeito pior. Ele some para parte dos visitantes e continua no ar para a outra parte, sem nenhum erro visível quando você consulta o DNS público. Quem usa um resolvedor validante (Google, Cloudflare, boa parte dos provedores de acesso brasileiros) recebe SERVFAIL. Quem usa um resolvedor que não valida continua enxergando o site normalmente, inclusive você no escritório.

A causa é sempre a mesma: o registrador continua publicando um registro DS que aponta para uma chave que o novo servidor de DNS não tem. O DS é o resumo criptográfico (digest) da DNSKEY, publicado na zona pai (no caso de `.br`, no Registro.br), e é ele que amarra a delegação à chave do servidor autoritativo. A chave fica no servidor autoritativo. Troque o servidor sem mexer no DS e os dois deixam de combinar. O resolvedor validante conclui que a resposta foi adulterada e recusa entregar qualquer coisa.

## O que inventariar antes de tocar no nameserver

Numa migração de carteira, o problema não é um domínio: são os três ou quatro domínios assinados que ninguém lembra que estão assinados, porque o DNSSEC foi ligado há dois anos por outra pessoa. O inventário precisa responder duas perguntas por domínio, e elas são independentes:

- **A zona está assinada no servidor de origem?** Isso você descobre no servidor, por conta.
- **O registrador publica DS?** Isso você descobre pela zona pai, com `dig`, de qualquer máquina.

As quatro combinações possíveis pedem ações diferentes:

| Zona assinada na origem | DS publicado no registrador | Situação | O que fazer antes de migrar |
|---|---|---|---||
| Sim | Sim | DNSSEC ativo de verdade | Remover o DS, esperar o TTL, migrar, reassinar no destino |
| Sim | Não | Assinada mas não validada | Migrar à vontade, não há validação em curso |
| Não | Sim | **DS órfão** | Remover o DS hoje, independente de migração |
| Não | Não | Sem DNSSEC | Migrar normalmente |

A terceira linha é a que mais aparece em carteira herdada. O domínio já está quebrado para alguém há meses e o cliente atribui isso a "internet da operadora".

## Como listar as zonas assinadas no servidor de origem

Em servidor cPanel/WHM, a documentação oficial descreve como listar os domínios com DNSSEC ativo usando a WHM API 1 pela linha de comando, com a função `fetch_ds_records_for_domains`, que devolve os registros DS correspondentes às chaves existentes na zona ([How to list domains with DNSSEC, cPanel](https://docs.cpanel.net/knowledge-base/dns/how-to-list-domains-with-dnssec/)).

Como root, para um domínio:

```bash
whmapi1 fetch_ds_records_for_domains domain=exemplo.com.br
```

Se a saída vier vazia para aquele domínio, não há chave na zona: não existe DNSSEC a desligar ali. Se vier com os dados do DS (key tag, algoritmo, digest), a zona está assinada na origem.

Para varrer a conta inteira sem digitar domínio por domínio, gere a lista a partir dos domínios do servidor e alimente a chamada:

```bash
for d in $(whmapi1 get_domain_info --output=jsonpretty \
  | grep '"domain"' | cut -d'"' -f4 | sort -u); do
  echo "== $d"
  whmapi1 fetch_ds_records_for_domains domain="$d"
done
```

Rode isso com saída redirecionada para arquivo. Vira o anexo da planilha de migração.

Se o servidor de origem não é cPanel, o equivalente é olhar a zona: com BIND, a presença de `.signed` no diretório de zonas ou de registros `DNSKEY`/`RRSIG` na resposta autoritativa já responde. Pergunte direto ao servidor de origem:

```bash
dig DNSKEY exemplo.com.br @ns1.servidorantigo.com.br +short
```

## Como conferir o DS que o registrador publica

Essa parte independe de acesso ao servidor. Pergunte direto aos servidores da zona pai:

```bash
dig DS exemplo.com.br @a.dns.br +noall +answer
```

Para `.com` e outros gTLDs, troque o destino por um servidor da zona pai correspondente, por exemplo `@a.gtld-servers.net`.

A resposta traz o DS e, na segunda coluna, o TTL em segundos. Esse é o TTL publicado, o número que define a janela de espera. Se você perguntar a um resolvedor recursivo (`@1.1.1.1`), o TTL que volta é o tempo restante do cache daquele resolvedor, já decrementado: anotar esse valor faz você subestimar a espera e migrar cedo demais. Não assuma um valor padrão, leia o que vier da zona pai.

Para confirmar se a validação está falhando agora, compare dois resolvedores:

```bash
dig A exemplo.com.br @1.1.1.1 +dnssec
dig A exemplo.com.br @ns1.servidorantigo.com.br
```

Se o primeiro devolve `status: SERVFAIL` e o segundo responde com o IP certo, o diagnóstico está fechado: a zona responde, a validação é que recusa. A flag `ad` presente na resposta do resolvedor validante indica o contrário, que a cadeia está íntegra.

No `.br`, o DS que está publicado também aparece no painel do Registro.br, na tela de DNS do domínio, junto com a opção de removê-lo. Para `.com` e outros gTLDs, a remoção é feita no painel do registrador onde o domínio está registrado.

## A ordem das quatro etapas, e por que invertê-la derruba o domínio

### Remover o DS no registrador antes de qualquer outra coisa

Primeiro passo, sempre. Enquanto houver DS, qualquer divergência de chave derruba o domínio para resolvedores validantes. Remova no Registro.br (ou no registrador do gTLD) antes de mexer em nameserver.

### Esperar o TTL do DS expirar nos resolvedores

O DS removido continua em cache nos resolvedores pelo tempo do TTL que você leu no `dig`. Durante essa janela, resolvedores que ainda têm o DS velho continuam exigindo assinatura. Espere o TTL inteiro e confirme:

```bash
dig DS exemplo.com.br @1.1.1.1 +noall +answer
```

Saída vazia em mais de um resolvedor público é o sinal verde.

### Trocar os nameservers e migrar a hospedagem

Agora a troca é uma migração de DNS comum. Vale a prática de sempre: baixar o TTL dos registros da zona antes, subir depois.

### Reassinar a zona no destino e publicar o DS novo

Com o site já respondendo no servidor novo, ative o DNSSEC na zona do destino, pegue o DS gerado lá e publique no registrador. No WHM, isso é feito na tela DNSSEC do Gerenciador de Zonas: gere a chave para a zona e copie o DS exibido ali. A documentação citada acima cobre só a listagem de domínios com DNSSEC, não a geração de chave. Publique só depois de o domínio estar estável no destino, nunca junto com a troca.

### O que fazer quando o site já caiu e não dá para remover antes

Se o site já está fora do ar e você está no modo emergência, a ordem é a mesma, só que comprimida: remova o DS primeiro, porque é ele que está bloqueando, e aceite que o restabelecimento depende do TTL expirar. Não existe atalho para invalidar cache de terceiro. Subir uma zona assinada com a chave antiga no servidor novo, se você tiver os arquivos de chave, resolve mais rápido, mas é remendo.

## Checklist de DNSSEC para aplicar na carteira inteira

- Levantar a lista de domínios da conta por servidor de origem.
- Rodar `fetch_ds_records_for_domains` por domínio e marcar quais têm chave na zona.
- Rodar `dig DS` contra a zona pai em cada domínio e anotar presença e TTL publicado.
- Classificar cada domínio nas quatro linhas da tabela acima.
- Remover o DS dos domínios das linhas 1 e 3. A linha 3 não espera migração, corrija hoje.
- Registrar data e hora da remoção ao lado do TTL lido, para saber quando o domínio está liberado.
- Migrar só os domínios cuja checagem de DS voltou vazia.
- Reassinar no destino e republicar o DS, domínio por domínio, depois da estabilização.
- Guardar a planilha. Ela vira o inventário de DNSSEC do cliente, que ninguém tinha.

## Como explicar ao cliente que o site sumiu só para alguns

O cliente vai dizer que o site abre no celular dele e não abre no computador da recepção. A explicação precisa caber em uma frase, sem aula de criptografia:

> **** O domínio tem uma assinatura de segurança registrada no registro do `.br`. Essa assinatura ficou apontando para o servidor antigo. Quem acessa por um provedor que confere essa assinatura recebe bloqueio e não enxerga o site; quem usa um provedor que não confere continua vendo normalmente. Já removemos a assinatura antiga e o acesso volta assim que os provedores atualizarem o cache, o que leva o tempo configurado no próprio registro do domínio.

Se o cliente perguntar por que não apareceu erro nos testes, a resposta honesta é que o DNS público respondeu certo o tempo todo: o que falhou foi a validação, e ferramenta de checagem que não valida DNSSEC não enxerga isso. É por isso que o `dig` da checagem precisa ir contra um resolvedor validante, e não contra o servidor autoritativo.

## DS órfão: o conserto de dois minutos que não exige migração

DNSSEC não é algo que se liga e esquece: ele cria uma dependência entre o registrador e o servidor autoritativo que precisa ser desfeita e refeita a cada troca de infraestrutura. Quem administra sites de terceiros ganha mais em tratar o inventário de DS como item fixo de onboarding do que em descobrir o problema com o cliente ligando. Se, ao rodar a varredura, você encontrar um domínio com DS publicado e zona sem chave, o conserto é de dois minutos no painel do registrador e não exige trocar nada de hospedagem. Faça esse conserto antes de vender qualquer migração.

