Skip to content

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

TXT

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

TXT レコード検証では、ホスト名の権威 DNS に TXT レコードを作成する必要があります。


使うタイミング

一般的には、証明書に DCV が必要 で、Delegated DCV を使えない場合に、TXT ベースの DCV が必要です。

セットアップ

DCV 方式を指定する

Universal SSL 証明書 を使う場合は、API 経由 で validation_method を編集し、使う検証方法を指定する必要があります。

または、ダッシュボードまたは API で 高度な証明書を注文 することもできます。

DCV の値を取得する

新しい証明書を作成 し、検証方法に TXT を選ぶと、数秒後にトークンが用意されます。

これらのトークンは、カスタムホスト名の作成時または証明書の更新時に、証明書が Pending Validation（検証待ち） の状態であるあいだ、API またはダッシュボードから取得できます。

これらのトークンは、API の GET リクエスト で、リクエストパラメーターに status=pending_validation を付けて取得できます。

たとえば、ワイルドカード証明書の API レスポンスでは、次の 2 つのトークンが強調表示されています。

レスポンスjson
{
  "result": [
    {
      "id": "<CERTIFICATE_ID>",
      "type": "advanced",
      "hosts": ["*.<DOMAIN>.com", "<DOMAIN>.com"],
      "primary_certificate": "0",
      "status": "pending_validation",
      "certificates": [],
      "created_on": "2022-10-12T21:46:21.979150Z",
      "validity_days": 90,
      "validation_method": "txt",
      "validation_records": [
        {
          "status": "pending",
          "txt_name": "_acme-challenge.<DOMAIN>.com",
          "txt_value": "lXLOcN6cPv0nproViNcUHcahD9TrIPlNgdwesj0pYpk"
        },
        {
          "status": "pending",
          "txt_name": "_acme-challenge.<DOMAIN>.com",
          "txt_value": "O0o8VgJu_OGu-T30_cvT-4xO5ZX1_2WsVNUrpUKE6ns"
        }
      ],
      "certificate_authority": "google"
    }
  ]
}

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

    Edge Certificates を開く ↗

  2. 証明書を選びます。

  3. Certificate validation TXT name と Certificate validation TXT value の値をコピーします。

ワイルドカード 証明書を作成していた場合は、検証用 TXT レコード 2 件の値をコピーする必要があります。

DNS レコードを更新する

権威 DNS プロバイダーで、名前が txt_name、値が txt_value の TXT レコードを作成します。

validation_records フィールドで返されたすべての DCV レコードについて、この手順を権威 DNS プロバイダーで繰り返します。

証明書上のホスト名のうち 1 つでも検証に失敗すると、証明書は発行または更新されません。

つまり、example.com と *.example.com を対象とするワイルドカード証明書では、権威 DNS プロバイダーに 2 つの DCV トークンを置く必要があります。同様に、SAN に 5 つのホスト名がある証明書（ワイルドカードを含む）では、権威 DNS プロバイダーに 5 つの DCV トークンを置く必要があります。 複数パック（RSA と ECDSA など）の証明書でも、複数の DCV トークンが必要になることがあります。

DCV を完了する

DNS レコードを更新したら、次の再試行を待つ か、即時の再チェックをリクエストできます。

すぐに再チェックする場合は、現在の検証方法と同じ validation_method でもう一度 PATCH リクエスト を送信します。

DCV に使った TXT レコードは、証明書が発行されたらすぐに権威 DNS プロバイダーから削除できます。

更新

部分 DNS セットアップ で証明書を発行する際に DCV を手動で行う場合でも、証明書の更新時には、Cloudflare が HTTP 経由で DCV を自動実行しようとします。

初回の試行で次の条件がすべて満たされている場合、更新は HTTP 経由で自動的に行われます。

  • ホスト名がプロキシされています。
  • 証明書上のホスト名が、ゾーンに割り当てられた IP に解決されます。
  • 証明書にワイルドカードが含まれていません。

いずれかの条件を満たさない場合、証明書の更新は選択した方式にフォールバックします。そのときは、DCV プロセスを手動でやり直す 必要があります。

Cloudflare は、証明書の有効期限の 30 日前に更新トークンを生成します。

役に立ちましたか？