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

Предварительная проверка

Методы предварительной проверки помогают подтвердить владение доменом ещё до того, как трафик вашего клиента начнёт проходить через прокси Cloudflare.

Используйте методы предварительной проверки, если ваши клиенты не могут допустить простоев, что часто характерно для продакшен-доменов.

Недостаток этих методов в том, что они требуют от ваших клиентов дополнительного шага при настройке, особенно если вам и так нужно, чтобы они добавили что-то в свой домен для проверка сертификата, предварительная проверка может усложнить их подключение.

Если ваши клиенты готовы смириться с небольшим простоем, а вы хотите упростить их настройку, ознакомьтесь с методы проверки в реальном времени.

Проверка TXT выполняется, когда ваш клиент добавляет TXT запись в своём авторитетном DNS, чтобы подтвердить владение доменом.

Чтобы настроить TXT проверка:

1. Когда вы создайте пользовательское имя хоста, сохраните ownership_verification информация.

   {
   "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. Попросите своего клиента добавить TXT запись с тем name и value у своего авторитативного DNS-провайдера.

3. Через несколько минут вы увидите, что статус имени хоста изменится на Активно в пользовательском интерфейсе.

4. Как только вы активируете пользовательское имя хоста, ваш клиент сможет удалить TXT запись.

Проверка HTTP выполняется, когда вы или ваш клиент размещаете HTTP-токен на его origin-сервере, чтобы подтвердить владение доменом.

Настройка проверки HTTP:

Когда вы создайте пользовательское имя хоста через API, Cloudflare предоставляет HTTP ownership_verification запись в ответе.

Чтобы получить и использовать ownership_verification запись:

1. Выполните вызов API к создайте Custom Hostname.

2. В ответе скопируйте http_url и http_body из ownership_verification_http объект:

   Пример ответа (сокращённый)

   {
     "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. Попросите своего клиента разместить http_url и http_body на своём исходном веб-сервере.

   Пример ответа (сокращённый)

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

   Cloudflare получит доступ к этому токену, отправив GET запросы к http_url с помощью User-Agent: Cloudflare Custom Hostname Verification.

4. Через несколько минут вы увидите, что статус имени хоста изменится на Активно в пользовательском интерфейсе.

5. Как только имя хоста станет активным, ваш клиент сможет удалить токен со своего origin-сервера.

Если вы подключаете клиента, чьё имя хоста уже работает у другого поставщика, для миграции без простоя можно использовать предварительную проверку в сочетании с ручным HTTP DCV:

1. Создайте пользовательское имя хоста с "ssl": {"method": "http", "type": "dv"}.
2. Завершите предварительная проверка владения именем хоста с помощью TXT-записи, чтобы имя хоста достигло status: active.
3. Дождитесь ssl.validation_records и заполните его значением токена HTTP DCV (это http_url и http_body пара).
4. Попросите клиента разместить токен DCV по http_url путь на своём текущем действующем исходном сервере. Удостоверяющий центр проверит его по текущей цели DNS.
5. Как только ssl.status достигает active, имя хоста и сертификат готовы.
6. Теперь ваш клиент может обновить свою DNS-запись CNAME, чтобы она указывала на вашу SaaS-цель без каких-либо перерывов: сертификат уже выпущен.