Use sua própria conta do Hetzner DNS para atender ao DNS dos seus domínios

O que a conexão faz por você

Conectar sua própria conta Hetzner permite que o DNS de um domínio seja servido a partir da sua conta em vez da nossa. Você mantém a zona, a fatura e o painel do provedor; nós criamos e atualizamos os registros de que seus sites e caixas postais precisam, para que você não precise copiá-los manualmente.

Antes de começar

Uma conta Hetzner com suas zonas no Hetzner Console. A Hetzner transferiu o DNS para o Hetzner Console, e o antigo console de DNS independente usa um tipo diferente de token que não funciona mais para isso — se suas zonas ainda estiverem lá, mova-as para o Hetzner Console primeiro. Os tokens pertencem a um projeto, portanto, use o projeto que contém suas zonas.

1. Crie a chave na Hetzner

No Hetzner Console, abra o projeto que contém suas zonas, escolha Security na barra lateral esquerda, depois API tokens na parte superior e Generate API token. Dê a ele uma descrição, escolha Read & Write — um token somente leitura pode listar suas zonas, mas não pode alterar um registro — e gere-o. Copie o token: a Hetzner não o exibirá novamente assim que a janela for fechada.

2. Conecte-a aqui

Abra Integrations em seu painel e escolha Connect an account. Selecione Your own DNS como o grupo e Hetzner DNS como a conta, preencha API token e pressione Connect account.

Nós testamos o que você colar antes que qualquer coisa seja salva. Uma chave que não funciona nunca é armazenada, e a resposta informa o que havia de errado com ela. Uma chave que funciona é mantida criptografada em nosso cofre de segredos — nunca em nosso banco de dados — e nunca é exibida novamente, nem mesmo para você.

O que acontece em seguida

• Em qualquer domínio, abra a aba DNS e escolha esta conta como o local a partir do qual o DNS do domínio é servido. Criaremos a zona lá caso ela não exista e registraremos as entradas de que os sites e e-mails do domínio precisam.
• Quando algo do nosso lado altera o conteúdo que um registro deve ter — você move um site, troca de CDN ou adiciona uma caixa postal —, nós atualizamos o registro em sua conta.
• Para concluir a migração, os servidores de nome (nameservers) do seu domínio devem apontar para a Hetzner. Se o domínio estiver registrado conosco ou em um registrador que você conectou, nós os definimos para você; caso contrário, a página do domínio exibirá os servidores de nome a serem definidos.
• Ao conectar, verificamos se a chave pode listar suas zonas, ler registros e alterar registros. A lista de verificação ao lado da conexão mostra quais dessas ações pudemos confirmar.

Se não conectar

Suas zonas não aparecem. O token pertence a um projeto diferente ou as zonas ainda estão no antigo console de DNS. Gere o token no projeto que as contém.

As alterações de registro são recusadas. O token foi criado como Read. Gere um token Read & Write e conecte-o.

Informa que a chave foi rejeitada. Quase sempre é uma de três coisas: um espaço ou quebra de linha copiado junto, uma chave expirada ou uma chave que foi revogada ou gerada novamente após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha mais tarde. A chave é autenticada, mas não possui a permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, depois desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrations, localize a conta e pressione Disconnect. Isso exclui a chave armazenada imediatamente. Qualquer coisa que a estivesse utilizando é interrompida na próxima ação, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.

A desconexão não desfaz o que já foi feito — registros, implantações ou configurações que alteramos em sua conta permanecem como estão. Se você achar que a própria chave pode ter vazado, revogue-a também no provedor; a desconexão remove a nossa cópia, não a deles.