Что дает подключение
Подключение вашего собственного аккаунта Hetzner позволяет обслуживать DNS домена из вашего аккаунта вместо нашего. Вы сохраняете за собой зону, оплату и панель управления поставщика; мы создаем и обновляем записи, необходимые для ваших сайтов и почтовых ящиков, чтобы вам не приходилось копировать их вручную.
Перед началом работы
Аккаунт Hetzner с вашими зонами в Hetzner Console. Hetzner перенес управление DNS в Hetzner Console, а старая отдельная консоль DNS Console использует другой тип токена, который больше не подходит для этих целей — если ваши зоны все еще там, сначала перенесите их в Hetzner Console. Токены привязаны к проекту, поэтому используйте проект, содержащий ваши зоны.
1. Создайте ключ в Hetzner
В Hetzner Console откройте проект, содержащий ваши зоны, выберите Security на панели слева, затем API tokens вверху и нажмите Generate API token. Укажите описание, выберите Read & Write (токен только для чтения может просматривать список ваших зон, но не может изменять записи) и сгенерируйте его. Скопируйте токен: Hetzner больше не покажет его после закрытия окна.
2. Подключите его здесь
Откройте раздел Интеграции в вашей панели управления и выберите Подключить аккаунт. Выберите Свой собственный DNS в качестве группы и Hetzner DNS в качестве аккаунта, заполните поле API token и нажмите Подключить аккаунт.
Мы проверяем вставленные данные перед сохранением. Неработающий ключ никогда не сохраняется, а в ответе указывается, что именно пошло не так. Работающий ключ хранится в зашифрованном виде в нашем хранилище секретов — ни в коем случае не в базе данных — и больше никогда не отображается, даже вам.
Что происходит дальше
- У любого домена откройте вкладку DNS и выберите этот аккаунт в качестве источника обслуживания DNS домена. Мы создадим там зону, если она не существует, и внесем записи, необходимые для сайтов и почты домена.
- Когда что-то на нашей стороне меняет требуемое значение записи — вы переносите сайт, переключаете CDN или добавляете почтовый ящик — мы обновляем запись в вашем аккаунте.
- Чтобы завершить перенос, серверы имен вашего домена должны указывать на Hetzner. Если домен зарегистрирован у нас или у подключенного вами регистратора, мы настроим их автоматически; в противном случае на странице домена будут показаны серверы имен, которые необходимо указать.
- При подключении мы проверяем, позволяет ли ключ просматривать список зон, читать записи и изменять их. Контрольный список рядом с подключением покажет, какие из этих действий удалось подтвердить.
Если подключение не удается
ваши зоны не отображаются. Токен принадлежит другому проекту или зоны все еще находятся в старой консоли DNS Console. Сгенерируйте токен в том проекте, где они расположены.
Отказ при изменении записей. Токен был создан с правами Read. Сгенерируйте токен Read & Write и подключите его.
Сообщение о том, что ключ отклонен. Почти всегда это одна из трех причин: пробел или перенос строки, скопированный вместе с ключом, истекший срок действия ключа, либо ключ был отозван или сгенерирован заново после того, как вы его скопировали. Создайте новый ключ и вставьте его снова.
Подключение успешно, но последующее действие завершается ошибкой. Ключ проходит аутентификацию, но не имеет разрешения, необходимого для действия. Создайте новый ключ с указанными выше разрешениями, затем отключите старое подключение и подключите новый ключ.
Отключение
Откройте раздел Интеграции, найдите аккаунт и нажмите Отключить. Это немедленно удалит сохраненный ключ. Любые процессы, использующие его, остановятся при следующем обращении, а экраны, зависящие от него, сообщат об этом вместо тихого сбоя.
Отключение не отменяет уже выполненных действий: записи, развертывания или настройки, измененные нами в вашем аккаунте, останутся без изменений. Если вы считаете, что сам ключ мог быть скомпрометирован, также отзовите его на стороне поставщика; отключение удаляет только нашу копию, но не их.