← Cloudflare for Platforms / cloudflare-for-platforms / cloudflare-for-saas / domain-support / hostname-validation

Předvalidace

Metody předvalidace pomáhají ověřit vlastnictví domény ještě před tím, než provoz vašeho zákazníka začne procházet přes Cloudflare.

Použijte metody předběžného ověření, pokud si vaši zákazníci nemohou dovolit žádný výpadek, k čemuž často dochází u produkčních domén.

Nevýhodou je, že tyto metody vyžadují od vašich zákazníků další krok při nastavení, zvlášť pokud po nich už stejně potřebujete, aby do své domény přidali něco kvůli ověření certifikátu, může předběžné ověření jejich onboarding zkomplikovat.

Pokud vaši zákazníci zvládnou krátký výpadek a chcete pro ně jednodušší nastavení, přečtěte si naši metody ověření v reálném čase.

Ověření TXT probíhá tak, že váš zákazník přidá TXT záznam do svého autoritativního DNS pro ověření vlastnictví domény.

Chcete-li nastavit TXT ověření:

1. Když vytvořte vlastní hostitelský název, uložte ownership_verification informace.

   {
   "result": [
       {
       "id": "3537a672-e4d8-4d89-aab9-26cb622918a1",
       "hostname": "app.example.com",
       // ...
       "status": "pending",
       "verification_errors": ["custom hostname does not CNAME to this zone."],
       "ownership_verification": {
           "type": "txt",
           "name": "_cf-custom-hostname.app.example.com",
           "value": "0e2d5a7f-1548-4f27-8c05-b577cb14f4ec"
       },
       "created_at": "2020-03-04T19:04:02.705068Z"
       }
   ]
   }

2. Nechte svého zákazníka přidat TXT záznam s daným name a value u svého autoritativního poskytovatele DNS.

3. Po několika minutách uvidíte, že se stav hostitelského názvu změní na Aktivní v uživatelském rozhraní.

4. Jakmile aktivujete vlastní hostitelský název, může váš zákazník odstranit TXT záznam.

Ověření HTTP probíhá tak, že vy nebo váš zákazník umístíte HTTP token na jejich origin server, čímž ověříte vlastnictví domény.

Chcete-li nastavit ověření HTTP:

Když vytvořte vlastní hostitelský název pomocí API vám Cloudflare poskytne HTTP ownership_verification záznam v odpovědi.

Chcete-li získat a použít ownership_verification záznam:

1. Proveďte volání API na vytvořte Custom Hostname.

2. V odpovědi zkopírujte http_url a http_body z ownership_verification_http objekt:

   Ukázková odpověď (zkrácená)

   {
     "result": [
       {
         "id": "24c8c68e-bec2-49b6-868e-f06373780630",
         "hostname": "app.example.com",
         // ...
         "ownership_verification_http": {
             "http_url": "http://app.example.com/.well-known/cf-custom-hostname-challenge/24c8c68e-bec2-49b6-868e-f06373780630",
             "http_body": "48b409f6-c886-406b-8cbc-0fbf59983555"
         },
         "created_at": "2020-03-04T20:06:04.117122Z"
       }
     ]
   }

3. Nechte svého zákazníka umístit http_url a http_body na svém origin serveru.

   Ukázková odpověď (zkrácená)

   location "/.well-known/cf-custom-hostname-challenge/24c8c68e-bec2-49b6-868e-f06373780630" {
       return 200 "48b409f6-c886-406b-8cbc-0fbf59983555\n";
   }

   Cloudflare k tomuto tokenu přistoupí odesláním GET požadavky na http_url pomocí User-Agent: Cloudflare Custom Hostname Verification.

4. Po několika minutách uvidíte, že se stav hostitelského názvu změní na Aktivní v uživatelském rozhraní.

5. Jakmile je hostitelský název aktivní, může váš zákazník odstranit token ze svého origin serveru.

Pokud onboardujete zákazníka, jehož hostitelský název už běží u jiného poskytovatele, můžete pomocí kombinace předběžného ověření a manuálního HTTP DCV dosáhnout migrace bez výpadku:

1. Vytvořte vlastní hostname s "ssl": {"method": "http", "type": "dv"}.
2. Dokončete předběžné ověření vlastnictví hostitelského názvu pomocí TXT záznamu, aby název hostitele dosáhl status: active.
3. Počkejte na ssl.validation_records a vyplňte jej hodnotou tokenu HTTP DCV (typu http_url a http_body pár).
4. Požádejte svého zákazníka, aby token DCV zpřístupnil na http_url cestu na svém aktuálním produkčním origin serveru. Certifikační autorita ji ověří proti aktuálnímu cíli DNS.
5. Jakmile ssl.status dosáhne active, jsou hostitelský název i certifikát připraveny.
6. Váš zákazník nyní může aktualizovat svůj DNS CNAME tak, aby směřoval na váš cíl SaaS bez přerušení: certifikát je již vydaný.