← Cloudflare Waiting Room / waiting-room / reference

Nastavení konfigurace

Pro své čekárny můžete přizpůsobit celou řadu možností.

Nastavení dashboardu

Nastavení		Poznámky
Nastavení dashboardu	Parametr API	Povinné?	Popis	Osvědčené postupy
Název	`name`	Ano	Jedinečný název čekárny.
Hostname	`host`	Ano	Hostname, pro který bude čekárna použita (bez zástupných znaků).	Nezahrnujte `http://` nebo `https://`.
Cesta	`path`	Ne	Cesta čekárny rozlišující velká a malá písmena. Čekárna bude povolena pro všechny podcesty. Zástupné znaky a parametry dotazu nejsou podporovány.	Pokud váš server nerozlišuje velká a malá písmena, použijte ve svém `path`.
Další hostname a cesty	`additional_routes`	Ne	Přidejte do pokrytí čekárny další hostname nebo cesty.	Další hostname musí patřit do stejné zóny. Kombinace hostname a cesty musí být pro každou čekárnu jedinečná.
Vlastní přípona cookie	`cookie_suffix`	Povinné při použití `additional_routes`.	Přizpůsobte příponu cookie své čekárny. Přípona bude přidána k `_cfwaitingroom`.	Zajistěte, aby název souboru cookie odpovídal požadavkům. Neměňte ho příliš často.
Total active users	`total_active_users`	Ano	Maximální počet povolených aktivních relací v `host/path` v daném okamžiku (musí být větší než 200).	Nastavte na 75% kapacity provozu originu a podle potřeby upravujte. Úpravy mohou ovlivnit odhadovanou dobu čekání zobrazenou koncovým uživatelům.
New users per minute	`new_users_per_minute`	Ano	A prahová hodnota uživatelů za minutu, kteří mohou být vpuštěni do `host/path`, větší než 200 a menší nebo rovno celkový počet aktivních uživatelů.	Nastavte na 100% špičkového provozu, aby byli uživatelé do fronty zařazováni pouze v nutných případech
Doba trvání relace	`session_duration`	Ne	Doba v minutách (mezi 1 a 30), po kterou uživatel, který opustil `host/path` mohou přicházet přímo zpět aniž by museli vstoupit do čekárny. Výchozí hodnota je 5 minut.
Zrušení relace		Ne	Relaci uživatele můžete zrušit, jakmile provede určitou akci, a to odesláním příkazu do waiting roomu prostřednictvím hlavičky HTTP v odpovědi z vašeho originu.	Povolte toto nastavení na dashboardu a přidejte `Cf-Waiting-Room-Command: revoke` hlavičku HTTP do odpovědi z vašeho origin serveru.
Popis	`description`	Ne	Popis čekárny.
Deaktivace obnovování relace	`disable_session_renewal`	Ne	K dispozici pouze pro zákazníky s plánem Enterprise po dokoupení. Pokud je hodnota true, mají uživatelé jen `session duration` minut na procházení vašeho webu. Pokud je hodnota false, soubor cookie relace uživatele se obnovuje při každém požadavku.
Odpověď JSON	`json_response_enabled`	Ne, výchozí hodnota je false.	Odeslat tělo JSON při obdržení `Accept: application/json` hlavička, běžně používaná u nativních mobilních aplikací.	Nastavte na `true` při použití čekárny pro provoz mimo prohlížeč. Postupujte podle tato dokumentace s dalšími kroky.
Stavový kód řazení do fronty	`queueing_status_code`	Ne, výchozí hodnota je `200` (OK).	Stavový kód HTTP, který se vrátí, zatímco uživatel čeká ve frontě.
Turnstile Widget Mode	`turnstile_mode`	Ano, výchozí `invisible`.	Typ widgetu Turnstile, který se má použít. Více informací najdete v dokumentace k Turnstile s podrobnostmi. Platné hodnoty jsou `off`, `invisible`, `visible_non_interactive`, a `visible_managed`. Nastavením této hodnoty na `off` úplně vypne integraci Turnstile.	Nastavením této hodnoty na `invisible` dává smysl pro většinu čekáren, pokud nechcete, aby koncoví uživatelé věděli, že probíhá challenge.
Turnstile Fail Action	`turnstile_action`	Ano, výchozí hodnota je `log`.	Akce, která se provede, pokud koncový uživatel neprojde výzvou Turnstile. Platné hodnoty jsou `log` a `infinite_queue`.	Nastavením této hodnoty na `log` dává smysl pro většinu čekáren, pokud nechcete agresivně blokovat boty pomocí nekonečné fronty.

Další podrobnosti

New users per minute

Když nakonfigurujete new users per minute, tato hodnota není počet uživatelů přidávaných za minutu.

Místo toho jde o práh počtu uživatelů povolených za minutu (menší nebo roven počtu total active users). Tuto hodnotu byste měli nastavit na 100 % očekávaného špičkového provozu, aby uživatelé byli do fronty zařazováni pouze v případě potřeby.

Doba trvání relace

Doba trvání relace zlepšuje uživatelský dojem dvěma způsoby.

Zaprvé zabraňuje tomu, aby návštěvníci museli kvůli stejné transakci procházet čekárnou dvakrát. Návštěvník může chtít například provést nákup na example.com. Velký provoz je na example.com, takže čekají ve frontě v čekárně, než vstoupí do internetového obchodu. Po určité době čekárnu opustí a vstoupí do internetového obchodu. Provedou nákup a internetový obchod opustí.

Zapomněli však k objednávce přidat poznámku nebo požádat o účtenku. Dokud jejich soubor cookie relace je stále platný (po dobu určenou parametrem session duration), mohou se do vaší aplikace vrátit, aniž by museli znovu čekat ve frontě v čekárně.

Za druhé, doba trvání relace umožňuje waiting roomu vytvářet dynamický odtok z vaší aplikace (kromě dynamického přítoku). Soubor cookie relace uživatele vyprší po období nečinnosti, což znamená, že se nová místa mohou uvolnit hned, jakmile je k dispozici volný prostor, a odhadovaná doba čekání je tak nižší a přesnější.