← Cloudflare Turnstile / turnstile / additional-configuration

Správa hostname

Správa hostname určuje, kde lze vaše widgety Turnstile použít: uvádíte v ní, které domény smějí widget načíst a spustit. Toto bezpečnostní opatření brání zneužití vašich widgetů na doménách, které nemáte pod kontrolou.

Pomocí funkce Hostname Management můžete k widgetu přiřadit názvy hostitelů a určit tak, kde jej lze používat. Správa názvů hostitelů zajistí, že Turnstile bude ve vašem prostředí fungovat správně, ať už přidáte samostatné názvy hostitelů, nebo využijete zóny registrované ve vašem účtu Cloudflare.

Požadavky na hostname

Standardní konfigurace

Ve výchozím nastavení vyžaduje každý widget alespoň jeden nakonfigurovaný hostname. Bez uvedení alespoň jednoho autorizovaného hostname widget nevytvoříte.

Požadavky na formát hostname

Při přidávání hostname dodržujte tyto požadavky:

Hostname musí být plně kvalifikované doménové názvy (FQDN): example.com nebo subdomain.example.com
Zástupné znaky (například *) v poli hostname podporované nejsou. Přidáním hostname ale automaticky autorizujete i všechny jeho subdomény.

Chování na subdoménách

Když přidáte hostname, widget bude fungovat na něm i na všech jeho subdoménách. Přidáním kořenové domény tedy pokryjete všechny subdomény pod ní, zatímco přidáním konkrétní subdomény omezíte widget jen na ni a na subdomény pod ní.

Příklad: kořenová doména

Přidání example.com jako hostname umožní widgetu fungovat na:

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

Příklad: konkrétní subdoména

Přidání www.example.com jako hostname umožňuje přísnější kontrolu. Widget bude fungovat na:

www.example.com
abc.www.example.com (subdomény zadaného hostname)

Bude však ne fungují na:

example.com (nadřazená doména)
dash.example.com (sousední subdoména)
cloudflare.com (nesouvisející doména)

Přidání názvů hostitelů

Stávající widget

V řídicím panelu Cloudflare přejděte na Turnstile .
Přejděte na Turnstile ↗
Vyberte existující widget.
Přejděte na Nastavení.
V části Správa hostname, vyberte Add Hostnames.
Přidejte vlastní název hostitele nebo vyberte některý z existujících.
Vyberte Add.

Nový widget

V řídicím panelu Cloudflare přejděte na Turnstile .
Přejděte na Turnstile ↗
Vyberte Přidání widgetu.
Do pole hostname zadejte své domény.
Pokud máte u Cloudflare registrované zóny, můžete vybírat z existujících zón

příkaz 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"]
  }'

Omezení

Uživatelé tarifu Free mohou mít u jednoho widgetu nejvýše 10 hostname.

Zákazníci s plánem Enterprise mohou mít až 200 hostname na jeden widget.