ナレッジベース

Cloudflare アカウントを Pages、CDN、DNS に接続する

Cloudflare API トークンを作成して接続すると、サイトを Cloudflare Pages に公開し、ご自身の Cloudflare アカウントからその DNS とキャッシュを提供できるようになります。

接続によるメリット

Cloudflareアカウントを連携すると、お客様のアカウント上の Cloudflare Pages に対して静的サイトを公開し、そこからサイトのDNSおよびキャッシュを提供できるようになります。すべてのデータはお客様ご自身のCloudflareダッシュボードおよびご自身のCloudflareプラン内で管理されます。

事前の準備

使用するドメインがゾーンとして追加されているCloudflareアカウント。無料プランでも連携が可能ですが、各ゾーンで実行できる操作はご契約のプランの内容に準じます。

1. Cloudflareでのキーの作成

Cloudflareダッシュボードで My Profile → API Tokens を開き、Create Token、次に Create Custom Token を選択します。名前を付け、以下の権限を追加し、Zone Resources でアクセスを許可するゾーン（すべてのゾーン、または指定したゾーンのみ）を選択します。内容を確認し、Create Token をクリックします。Cloudflareにトークンが表示されるのは一度のみですので、その際にコピーしてください。

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

Zone → Zone → Read
Zone → DNS → Edit
Zone → Cache Purge → Purge
Zone → Zone Settings → Edit
Account → Cloudflare Pages → Edit — Pagesへのサイト公開を弊社に許可する場合のみ。この権限がないトークンでも連携は可能で、DNSとキャッシュには機能します。

従来の代替手段。 トークンの代わりに、Global API Key およびサインインに使用するメールアドレスを使用して接続することもできます（My Profile → API Tokens → API Keys → Global API Key → View）。Cloudflareではこれをお勧めしません。Global API Keyには、ログイン中のアカウントが持つすべてのゾーンに対するすべての権限が付与され、権限の範囲を狭めることができないためです。可能な限りトークンを使用してください。

2. ここでの連携

ダッシュボードで Integrations を開き、Connect an account を選択します。グループとして Cloudflare account (Pages, CDN & DNS) を、アカウントとして Cloudflare を選び、API token（または従来の代替手段の場合は API key と Account email）を入力して、Connect account をクリックします。

入力された内容は、保存される前にテストされます。機能しないキーが保存されることは一切なく、エラー内容がメッセージとして表示されます。正常に機能するキーは、データベース内ではなく弊社のシークレット・ボルト内で暗号化されて保管され、お客様ご自身を含め、二度と再表示されることはありません。

その後の処理

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

CDNとDNSを別々のCloudflareアカウントに維持したい場合は、代わりに Cloudflare CDN および Cloudflare DNS として個別に連携してください（それぞれに専用の手順ガイドがあります）。

接続できない場合

権限が「未確認」と表示される場合。 Cloudflareの仕様上、トークンが自身の権限リストを常に取得できるとは限らないため、一部の権限は初回使用時に確認されます。後ほど権限エラーで操作が失敗した場合は、My Profile → API Tokens でトークンを編集し、不足している権限を追加してください。トークンの値自体は変更されないため、再接続の必要はありません。

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

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

接続はできたが、後で処理が失敗する場合。 キーの認証は成功しているものの、操作に必要な権限が不足しています。上記の権限を持つ新しいキーを作成し、古い接続を切断してから新しいキーで接続してください。

接続の解除

Integrations を開き、該当のアカウントを見つけて Disconnect をクリックします。これにより、保存されていたキーが即座に削除されます。そのキーを使用していたすべての機能は次回の実行時に停止し、影響を受ける画面ではサイレントエラーになる代わりにその旨が表示されます。

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