blog
Domínios e DNS

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.

JR · · 8 min de leitura · 1 tabela · 6 blocos de código

Resposta curta: 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.

Neste artigo
  1. O que inventariar antes de tocar no nameserver
  2. Como listar as zonas assinadas no servidor de origem
  3. Como conferir o DS que o registrador publica
  4. A ordem das quatro etapas, e por que invertê-la derruba o domínio
  5. Checklist de DNSSEC para aplicar na carteira inteira
  6. Como explicar ao cliente que o site sumiu só para alguns
  7. DS órfão: o conserto de dois minutos que não exige migração

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:

  1. A zona está assinada no servidor de origem? Isso você descobre no servidor, por conta.
  2. 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".

Inventário: assinatura na origem e DS na zona paiAssinada e com DSRemova o DS antes de migrarAssinada, sem DSPode migrar, ninguém validaSem chave, com DSDS órfão: remova hojeSem chave, sem DSMigração comum, sem cuidado extra
As quatro combinações do inventário e a ação correspondente por domínio. Zona assinada se verifica no servidor de origem; DS se verifica na zona pai com dig.

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

Como root, para um domínio:

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:

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:

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:

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:

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:

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.

Ordem das quatro etapas da troca com DNSSECRemover o DSNo Registro.br ou no registradorEsperar o TTLdig DS vazio em resolvedoresTrocar nameserverMigração de DNS comumReassinar no destinoPublicar o DS novo depois
A ordem não é negociável: inverter qualquer par derruba o domínio para quem usa resolvedor validante.

Checklist de DNSSEC para aplicar na carteira inteira

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:

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.

Referências

  1. Documentação oficial (cpanel) — How to list domains with DNSSEC. Consultado em 2026-10-16.
Leia também