← Cloudflare Turnstile / turnstile / additional-configuration

Управление именами хостов

Управление именами хостов задаёт, где можно использовать ваши виджеты Turnstile: вы указываете, каким доменам разрешено загружать и выполнять их. Эта мера защиты не позволяет использовать ваши виджеты на доменах, которые вам не подконтрольны.

К виджету можно привязать имена хостов и задать таким образом, где его разрешено использовать: это делается в разделе Hostname Management. Управление именами хостов гарантирует корректную работу Turnstile в вашей конфигурации, независимо от того, добавляете ли вы отдельные имена хостов или используете зоны, зарегистрированные в вашей учётной записи Cloudflare.

Требования к именам хостов

Стандартная конфигурация

По умолчанию для каждого виджета нужно задать хотя бы одно имя хоста. Создать виджет, не указав ни одного разрешённого имени хоста, нельзя.

Требования к формату имени хоста

При добавлении имён хостов соблюдайте следующие требования:

Имена хостов должны быть полными доменными именами (FQDN): example.com или subdomain.example.com
Подстановочные символы (например, *) в поле имени хоста не поддерживаются. При этом добавление имени хоста автоматически разрешает все его поддомены.

Поведение на поддоменах

Добавленное имя хоста разрешает виджету работать и на нём самом, и на всех его поддоменах. То есть корневой домен покрывает все поддомены под ним, а конкретный поддомен ограничивает виджет только этим поддоменом и его дочерними.

Пример: корневой домен

Добавление example.com в качестве имени узла разрешит виджету работать на:

example.com
www.example.com
shop.example.com
any.sub.example.com

Пример: конкретный поддомен

Добавление www.example.com в качестве имени узла даёт более строгий контроль. Виджет будет работать на:

www.example.com
abc.www.example.com (поддомены указанного имени узла)

Однако он не работают на:

example.com (родительский домен)
dash.example.com (соседний поддомен)
cloudflare.com (посторонний домен)

Добавьте имена хостов

Существующий виджет

На панели управления Cloudflare перейдите к разделу Turnstile страницу.
Перейдите в Turnstile ↗
Выберите существующий виджет.
Перейдите в Настройки.
В разделе Управление именами хостов, выберите Add Hostnames.
Добавьте новое имя хоста или выберите одно из существующих.
Выберите Add.

Новый виджет

На панели управления Cloudflare перейдите к разделу Turnstile страницу.
Перейдите в Turnstile ↗
Выберите Добавить виджет.
В поле hostname введите свой домен или домены.
Если у вас есть зоны, зарегистрированные в Cloudflare, вы можете выбрать одну из существующих зон

команда cURL

  curl -X PUT "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$WIDGET_ID" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "domains": ["example.com", "app.example.com", "api.example.com"]
  }'

Ограничения

Пользователям плана Free доступно не более 10 имён хостов на виджет.

Клиентам Enterprise доступно до 200 имён хостов на один виджет.