ナレッジベース

Pages、CDN、DNS を利用するために Cloudflare アカウントを連携してください

サイトを Cloudflare Pages に公開し、お客様自身の Cloudflare アカウントから DNS およびキャッシュを提供できるように、Cloudflare API トークンを作成して接続してください。

連携によってできること

Cloudflare アカウントを連携すると、お客様のアカウント上のCloudflare Pagesへの静的サイトの公開や、そこからのサイトの DNS およびキャッシュの配信が可能になります。すべてはお客様ご自身の Cloudflare ダッシュボード内およびご契約の Cloudflare プラン上で管理されます。

開始前の準備

Cloudflare アカウントと、利用するドメインがゾーンとして追加されている必要があります。連携には無料プランで十分ですが、各ゾーンで実行できる操作はお客様のプランで許可されている内容に準じます。

1. Cloudflare でキーを作成する

Cloudflare ダッシュボードでマイプロフィール → API トークンを開き、トークンを作成、次にカスタムトークンを作成を選択します。名前を付け、以下の権限を追加し、ゾーンリソースでお客様がアクセスを許可するゾーン (すべてのゾーン、または指定したゾーンのみ) を選択します。内容を確認してトークンを作成を押します。Cloudflare がトークンを表示するのは一度だけですので、その際にコピーしてください。

以下の権限を追加します。

ゾーン → ゾーン → 読み取り
ゾーン → DNS → 編集
ゾーン → キャッシュのパージ → パージ
ゾーン → ゾーン設定 → 編集
アカウント → Cloudflare Pages → 編集 — Pages へのサイト公開を希望する場合のみ。この権限がないトークンでも連携は可能で、DNS およびキャッシュに対して機能します。

以前の代替方法。 トークンの代わりに、グローバル API キーとサインイン用メールアドレスで連携することもできます (マイプロフィール → API トークン → API キー → グローバル API キー → 表示)。Cloudflare ではこの方法を非推奨としています。グローバル API キーはお客様のログインが持つすべての権限を全ゾーンに対して保持し、制限することができないためです。可能な限りトークンをご使用ください。

2. こちらで連携する

ダッシュボードで連携を開き、アカウントを連携を選択します。グループとしてCloudflare アカウント (Pages、CDN および DNS)、アカウントとしてCloudflareを選択し、API トークン (または以前の代替方法の場合はAPI キーとアカウントのメールアドレス) を入力して、アカウントを連携を押します。

何かを保存する前に、貼り付けられた内容をテストします。機能しないキーが保存されることは決してなく、エラーの原因が表示されます。機能するキーは機密情報ボルト内に暗号化されて保管され (データベースには決して保存されません)、お客様に対しても二度と表示されません。

次のステップ

静的サイトを作成または移行する際、デプロイ先としてCloudflare Pagesが表示され、お客様のアカウント上の Pages プロジェクトにビルドが公開されます。
お客様のゾーンから、このアカウントを経由してドメインの DNS およびサイトのキャッシュを配信できます。
トークンがゾーンの読み取り、DNS の編集、キャッシュのパージ、ゾーン設定の変更を行えるか確認します。連携の横にあるチェックリストには、確認できた項目が表示されます。

CDN と DNS を別々のCloudflare アカウントで管理したい場合は、代わりにCloudflare CDNとCloudflare DNSとして個別に連携してください。それぞれに専用のガイドが用意されています。

連携できない場合

権限が未確認と表示される場合。 Cloudflare ではトークンが自身の権限一覧を取得することを常に許可しているわけではないため、一部の権限は初回使用時に確認されます。後から権限エラーでアクションが失敗した場合は、マイプロフィール → API トークンでトークンを編集し、不足している権限を追加してください。トークンの値自体は変わらないため、再連携の必要はありません。

ゾーンが見つからない場合。 トークンのゾーンリソースにそのゾーンが含まれていません。そのゾーン、またはすべてのゾーンを含めるようにトークンを編集してください。

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

連携はできるが、後から何かが失敗する場合。 キーの認証には成功しているものの、アクションに必要な権限が不足しています。上記に記載された権限を持つ新しいキーを作成し、古い連携を解除してから新しいキーを連携してください。

連携解除

連携を開き、該当のアカウントを見つけて連携解除を押します。これにより、保存されていたキーは直ちに削除されます。そのキーを使用していたすべての処理は次回のアクション時に停止し、依存していた画面には通知なく失敗する代わりにその旨が表示されます。

連携を解除しても、既に行われた処理が取り消されることはありません。お客様のアカウントで変更されたレコード、デプロイ、設定はそのまま残ります。キー自体の漏洩が疑われる場合は、提供元 (Cloudflare) でもキーを無効化してください。ここでの連携解除は提供元のキーではなく、弊社側のコピーを削除するのみです。