Skip to content

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

HTTP

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

HTTP 検証では、お客様のオリジンに DCV トークンを追加します。

カスタムホスト名を作成 するときに、証明書の検証方法を 1 つ選びます。API が受け付ける ssl.method の値は http、txt、email のいずれか 1 つです。

ワイルドカードなしのカスタムホスト名

カスタムホスト名にワイルドカードが含まれない場合、検証方法に TXT を選んでいても、ホスト名が SaaS ターゲットを指したあとに Cloudflare は HTTP 検証 で DCV の完了を試みます。

お客様のホスト名が SaaS ターゲットを指しており、選んだ認証局をブロックする CAA レコード がなければ、この HTTP 検証は成功するはずです。

ワイルドカードのカスタムホスト名

ワイルドカード証明書では HTTP による DCV は使えません。代わりに TXT 検証 を使ってください。Delegated DCV を設定すると、TXT ベースの検証を自動化できます。

検証方法

HTTP（自動）

手順を簡単にしたい場合で、お客様が数分のダウンタイムを許容できるなら、Cloudflare の自動 HTTP 検証に任せられます。

新しいホスト名を作成 して検証方法に http を選んだあと、お客様が行うのは $CNAME_TARGET への CNAME 追加だけです。残りは Cloudflare が処理します。

自動 HTTP 検証はその場で動作します。お客様がホスト名を SaaS ターゲットへ向けると、Cloudflare はエッジから認証局の HTTP DCV トークンを配信し、証明書検証を完了できます。

その期間中、証明書が ssl.status: active になる前にホスト名が Cloudflare へルーティングされることがあります。お客様が DNS を変更する前に証明書を有効にしたい場合は、代わりに TXT 検証 または Delegated DCV を使ってください。

カスタムホスト名を作成したあとの動作

Cloudflare は認証局（CA）プロバイダーの 1 つに連絡し、指定したホスト名の証明書発行を依頼します。その後 CA は、ホスト名の管理権限を示すために、指定された $DCV_FILENAME で $DCV_TOKEN を返す必要があると Cloudflare に通知します。トークンとファイル名はどちらも CA がランダムに生成し、Cloudflare は事前に知りません。

たとえば site.example.com のカスタムホスト名を新規作成すると、CA は http://site.example.com/.well-known/pki-validation/ca3-39f423f095be4983922ca0365308612d.txt" へのリクエストに対して ca3-38734555d85e4421beb4a3e6d1645fe6 を返すよう求めることがあります。CA からその値を受け取るとすぐに、エッジでアクセスできるようにして CA に確認を依頼し、検証と証明書の注文を完了してもらいます。

お客様に CNAME の更新を依頼する前（または、ターゲット CNAME の解決先を Cloudflare のプロキシに切り替える前）に発行を完了したい場合は、別の検証方法を選んでください。

HTTP（手動）

新しいホスト名を作成 し、この検証方法を選ぶと、数秒後に次の値が表示されます。


  • API: ssl オブジェクト内の validation_records 配列にある値（特に http_url と http_body）を保存します。
  • ダッシュボード: Custom Hostnames ↗ ページで個別の証明書を見るとき、Certificate validation request と Certificate validation response の値を確認します。

オリジンでは、http_url で指定されたパスの TXT レコードとして http_body を公開します。認証局がアクセスできるよう、このパスはインターネット上の誰からでも到達できる必要があります。

トークンを返す NGINX 設定の例です。

location "/.well-known/pki-validation/ca3-0052344e54074d9693e89e27486692d6.txt" {
       return 200 "ca3-be794c5f757b468eba805d1a705e44f6\n";
}

設定が公開されたら、curl で DCV テキストファイルの配置を確認します。

curl "http://http-preval.example.com/.well-known/pki-validation/ca3-0052344e54074d9693e89e27486692d6.txt"
ca3-be794c5f757b468eba805d1a705e44f6

トークンの有効期間は 1 回のチェック周期です。次のチェック周期で、Cloudflare は認証局に URL の再確認を依頼し、検証を完了して証明書を発行します。

即時再チェックを依頼する場合は、次の再試行を待つのではなく、最初の POST リクエストと同じ値で PATCH リクエスト を送ります。

役に立ちましたか？