お客様ご自身のHetzner DNSアカウントを使用して、ドメインのDNSを管理できます

連携により実現すること

お客様ご自身の Hetzner アカウントを連携すると、ドメインの DNS を弊社のサーバーではなくお客様のアカウントで運用できるようになります。ゾーン、請求、ベンダーのダッシュボードはお客様の手元に残ります。弊社がサイトやメールボックスに必要なレコードの作成と更新を行うため、手動でコピーする必要はありません。

始める前に

ゾーンが保存されている Hetzner Console の Hetzner アカウントが必要です。Hetzner は DNS を Hetzner Console に移行しました。古いスタンドアロンの DNS Console は、この連携では機能しなくなった別の種類のトークンを使用します。ゾーンがまだそちらにある場合は、まず Hetzner Console に移行してください。トークンはプロジェクトに紐づくため、ゾーンを管理しているプロジェクトを使用してください。

1. Hetzner でキーを作成する

Hetzner Console でゾーンを管理しているプロジェクトを開き、左側サイドバーの Security を選択し、上部の API tokens を選択して、Generate API token をクリックします。説明を入力し、Read & Write を選択します（読み取り専用のトークンではゾーンの一覧表示はできてもレコードの変更はできません）。そしてトークンを生成します。トークンをコピーしてください。Hetzner ではウィンドウを閉じると、二度とトークンが表示されません。

2. ここで連携する

ダッシュボードで Integrations を開き、Connect an account を選択します。グループとして Your own DNS を、アカウントとして Hetzner DNS を選び、API token を入力して Connect account を押します。

入力された内容は保存前にテストされます。動作しないキーが保存されることは決してありません。また、何が問題であったかがエラーメッセージに表示されます。正常に動作するキーはデータベースではなく弊社のシークレット vault 内に暗号化されて保存され、お客様自身を含め、二度と表示されることはありません。

次に起こること

• 任意のドメインの DNS タブを開き、ドメインの DNS の配信元としてこのアカウントを選択します。ゾーンが存在しない場合はそこで作成され、ドメインのサイトやメールに必要なレコードが書き込まれます。
• レコードの内容を変更すべき事象が弊社側で発生した場合（サイトの移動、CDN の切り替え、メールボックスの追加など）、お客様のアカウント上のレコードが更新されます。
• 移行を完了するには、ドメインのネームサーバーが Hetzner を指している必要があります。ドメインが弊社で登録されている場合、または連携済みのレジストラで登録されている場合は、弊社側で設定を行います。それ以外の場合は、ドメインのページに設定すべきネームサーバーが表示されます。
• 連携時に、キーによってゾーンの一覧表示、レコードの読み取り、レコードの変更が可能であるかどうかが確認されます。連携の横にあるチェックリストには、確認できた項目が表示されます。

連携できない場合

ゾーンが表示されない。 トークンが別のプロジェクトのものであるか、ゾーンが古い DNS プレフィックスの DNS Console に残っています。ゾーンを管理しているプロジェクトでトークンを生成してください。

レコードの変更が拒否される。 トークンが Read として作成されています。Read & Write のトークンを生成して連携してください。

キーが拒否されたと表示される。 ほとんどの場合、以下の 3 つのいずれかが原因です。コピー時にスペースや改行が混入した、有効期限が切れた、またはコピーした後にキーが無効化されたか再生成された。新しいキーを作成し、再度貼り付けてください。

接続は成功するが、後続の処理で失敗する。 認証は成功するものの、そのアクションに必要な権限が不足しています。前述の権限を持つ新しいキーを作成し、古い連携を解除してから新しいキーで連携してください。

連携の解除

Integrations を開き、該当するアカウントを見つけて Disconnect を押します。これにより、保存されているキーが即座に削除されます。そのキーを使用していたすべての処理は次のアクション実行時に停止し、静かに失敗する代わりに、依存していた画面にその旨が表示されます。

連携を解除しても、すでに実行された内容（お客様のアカウント上で変更したレコード、デプロイメント、設定）は元に戻りません。キー自体が漏洩した可能性があると思われる場合は、ベンダー側でもキーを無効化してください。連携の解除によって削除されるのは弊社のコピーであり、ベンダー側のコピーではありません。