Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Cloudflare for SaaS の設定

最終更新 Markdown で表示Agent セットアップ

始める前に

カスタムホスト名の作成を始める前に、次の作業を完了します。

  1. ゾーンを Cloudflare on a Free plan. に 追加 します。
  2. ゾーンで Cloudflare for SaaS を 有効 にします。
  3. ホスト名の優先順位に関するガイドライン を確認します。ワイルドカードのカスタムホスト名は、完全一致のホスト名とは動作が異なります。
  4. （任意）次のドキュメントを確認します。

初期設定

Cloudflare for SaaS を初めて 有効化 したときは、カスタムホスト名を作成する前に、いくつかの手順が必要です。


1. Fallback Origin を作成する

フォールバックオリジンは、カスタムホスト名宛てのトラフィックを Cloudflare がルーティングする先です（プロキシされている必要があります）。

フォールバックオリジンを作成する手順は次のとおりです。

  1. フォールバックオリジンの IP アドレス（Cloudflare がカスタムホスト名のトラフィックを送る先）を指す、プロキシ済みの A、AAAA、または CNAME レコードを 作成 します。
タイプ 名前 IPv4 アドレス プロキシ状態
A proxy-fallback 192.0.2.1 Proxied
  1. そのレコードをフォールバックオリジンとして指定します。

  1. Cloudflare ダッシュボードで Custom Hostnames ページを開きます。

    Custom Hostnames を開く ↗

  2. Fallback Origin に、フォールバックオリジンのホスト名を入力します。

  3. Add Fallback Origin を選択します。

先ほど作成したレコードのホスト名を使い、フォールバックオリジンの値を更新 します。

  1. フォールバックオリジンを追加したら、ステータスが Active であることを確認します。

2.（任意）CNAME ターゲットを作成する

CNAME ターゲットは任意ですが、強く推奨します。顧客が トラフィックをルーティング しやすい、柔軟な名前を用意できます。customers.<SAAS_PROVIDER>.com のようなサブドメインを使うとよいでしょう。

CNAME ターゲットから Fallback Origin を指す、プロキシ済みの CNAME を 作成 します（*.customers.saasprovider.com のようなワイルドカードでも構いません）。

タイプ 名前 ターゲット プロキシ状態
CNAME .customers proxy-fallback.saasprovider.com Proxied

ホスト名ごとの設定

カスタムホスト名ごとに、次の手順を実行します。

1. 検証を計画する

ホスト名を作成する前に、次を計画します。

  1. 証明書の検証: 検証に成功すると、証明書は Cloudflare のグローバルネットワークへデプロイされます。
  2. ホスト名の検証: 検証に成功すると、Cloudflare はこのホスト名のトラフィックをプロキシします。

ホスト名が期待どおりに動作するには、両方の手順を完了する必要があります。

2. カスタムホスト名を作成する

証明書とホスト名の検証を計画したあと、カスタムホスト名を作成できます。

カスタムホスト名を作成する手順は次のとおりです。

  1. Cloudflare ダッシュボードで Custom Hostnames ページを開きます。

    Custom Hostnames を開く ↗

  2. Add Custom Hostname を選択します。

  3. 顧客のホスト名 app.customer.com を追加し、次の関連オプションを設定します。

  4. Add Custom Hostname を選択します。

  1. API でカスタムホスト名を作成するには、Create Custom Hostname エンドポイントを使います。

    • certificate_authority パラメーターで CA（認証局）を指定する、custom_certificate / custom_cert_bundle でカスタム証明書をアップロードする、または wildcard でワイルドカード証明書を作成できるのは、Enterprise のお客様だけです。詳細は プラン を参照してください。
    • certificate_authority パラメーターは空のままにして、「デフォルト CA」に設定できます。この場合、Cloudflare は証明書をリクエストする前に CAA レコードを確認します。これにより、その CA から証明書を発行できる可能性が高まります。

  2. 新しく作成したカスタムホスト名では、POST の応答に DCV 検証トークン validation_records が含まれないことがあります。これらの詳細を取得するには、（間隔を空けて）2 回目の GET コマンド を実行することをおすすめします。

応答には、新しいカスタムホスト名の完全な定義が含まれます。

カスタムホスト名の準備完了を確認する

カスタムホスト名では、ホスト名の有効化と証明書の発行で、検証の流れが分かれます。

API フィールド 意味 準備完了の値
result.status Cloudflare がホスト名を検証し、そのホスト名のトラフィックをプロキシできる状態です。 active
result.ssl.status Cloudflare がそのホスト名の証明書を発行し、デプロイ済みです。 active

本番トラフィックに使える状態は、次をすべて満たしたときです。

  • result.status が active である
  • result.ssl.status が active である
  • ホスト名の DNS レコードが SaaS ターゲットを指している

Cloudflare が別の一致する証明書を提示できる場合、result.ssl.status が active になる前に TLS ハンドシェイクが成功することがあります。オンボーディング状態の正は Custom hostname details エンドポイント です。詳細は 証明書とホスト名の優先度 を参照してください。

3. 顧客に CNAME レコードを作成してもらう

カスタムホスト名の設定を完了するには、顧客が権威 DNS に、CNAME ターゲット を指す CNAME レコードを置く必要があります 1。

顧客の CNAME レコードは、次のような形になります。

mystore.example.com CNAME customers.saasprovider.com

このレコードは、次のようにトラフィックをルーティングします。

flowchart TD
accTitle: CNAME ターゲットによるトラフィックルーティング
A[リクエスト: <code>mystore.example.com</code>] --> B[<code>customers.saasprovider.com</code>]
B --> C[<code>proxy-fallback.saasprovider.com</code>]

mystore.example.com へのリクエストは CNAME ターゲット（customers.saasprovider.com）へ行き、そこから Fallback Origin（proxy-fallback.saasprovider.com）へルーティングされます。

サービスの継続

お客様がドメインでも Cloudflare を使っている場合、サービスを使い続けるあいだは、SaaS プロバイダーを指す DNS レコードを残してください。

詳細は カスタムホスト名を削除する を参照してください。

Footnotes

  1. カスタムホスト名に Regional Services を設定している場合、Cloudflare は常に DNS ターゲットレコードに関連付けられた処理リージョンを使います（カスタムオリジン の処理リージョンではありません）。

    ↩

役に立ちましたか？