← Cloudflare Waiting Room / waiting-room / reference

Параметры конфигурации

Для залов ожидания доступны разные варианты настройки.

Параметры дашборда Дополнительные сведения

Параметры дашборда

Настройки		Примечания
Параметр дашборда	Параметр API	Обязательно?	Описание	Рекомендации
Название	`name`	Да	Уникальное имя зала ожидания.
Имя хоста	`host`	Да	Имя хоста, к которому будет применяться зал ожидания (без подстановочных знаков).	Не включайте `http://` или `https://`.
Путь	`path`	Нет	Путь зала ожидания с учетом регистра. Зал ожидания будет включён для всех подпутей. Подстановочные знаки и параметры запроса не поддерживаются.	Если ваш сервер не поддерживает использование разного регистра букв, используйте цифры в своём `path`.
Дополнительные имена хостов и пути	`additional_routes`	Нет	Добавьте дополнительные имена хостов и (или) пути в зону охвата вашего зала ожидания.	Дополнительные имена хостов должны относиться к той же зоне. Комбинации имени хоста и пути должны быть уникальными в пределах одного зала ожидания.
Пользовательский суффикс cookie	`cookie_suffix`	Обязательно при использовании `additional_routes`.	Настройте суффикс cookie вашего зала ожидания. Суффикс будет добавлен к `_cfwaitingroom`.	Убедитесь, что имя cookie-файла соответствует требованиям. Не изменяйте его слишком часто.
Total active users	`total_active_users`	Да	Максимальное количество активных сессий, разрешённое в `host/path` в заданный момент времени (должно быть больше 200).	Установите 75% от пропускной способности источника трафика и корректируйте по мере необходимости. Изменения могут повлиять на расчётное время ожидания, отображаемое конечным пользователям.
New users per minute	`new_users_per_minute`	Да	A пороговое значение пользователей в минуту, которых можно допустить в `host/path`, больше 200 и меньше или равно общее количество активных пользователей.	Установите значение 100% от пикового трафика, чтобы пользователи попадали в очередь только при необходимости
Длительность сессии	`session_duration`	Нет	Время в минутах (от 1 до 30), в течение которого пользователь, который покинул `host/path` может поступать сразу обратно не попадая в зал ожидания. По умолчанию составляет 5 минут.
Отзыв сессии		Нет	Отзывайте сессию пользователя при совершении им определённого действия, отправляя команду в зал ожидания через HTTP-заголовок в ответе с вашего источника.	Включите этот параметр в панели управления и добавьте `Cf-Waiting-Room-Command: revoke` HTTP-заголовок к ответу от вашего источника.
Описание	`description`	Нет	Описание зала ожидания.
Отключение продления сеанса	`disable_session_renewal`	Нет	Доступно только клиентам с планом Enterprise при дополнительной покупке. Если указано значение true, у пользователей есть только `session duration` минут на просмотр вашего сайта. Если значение false, cookie-файл сессии пользователя обновляется при каждом запросе.
Ответ JSON	`json_response_enabled`	Нет, по умолчанию false.	Отправляйте тело JSON при получении `Accept: application/json` заголовок, обычно используемый в нативных мобильных приложениях.	Установите значение `true` при использовании зала ожидания для трафика, не связанного с браузером. Следуйте эта документация дополнительные шаги.
Код состояния очереди	`queueing_status_code`	Нет, по умолчанию `200` (OK).	Код состояния HTTP, возвращаемый, пока пользователь находится в очереди.
Turnstile Widget Mode	`turnstile_mode`	Да, по умолчанию используется `invisible`.	Тип используемого виджета Turnstile, подробнее см. в документация Turnstile подробнее. Допустимые значения: `off`, `invisible`, `visible_non_interactive`, а также `visible_managed`. Если установить это значение в `off` полностью отключит интеграцию Turnstile.	Если для этого параметра задано значение `invisible` подходит для большинства Waiting Room, если только вы не хотите, чтобы конечные пользователи знали, что проверка выполняется.
Turnstile Fail Action	`turnstile_action`	Да, значение по умолчанию: `log`.	Действие, которое выполняется, если пользователь не проходит проверку Turnstile. Допустимые значения: `log` и `infinite_queue`.	Если для этого параметра задано значение `log` подходит для большинства Waiting Room, если только вы не хотите агрессивно блокировать ботов с помощью бесконечной очереди.

Дополнительные сведения

New users per minute

Когда вы настраиваете new users per minute, это значение не является количество пользователей, добавляемых в минуту.

Вместо этого это пороговое значение количества пользователей, допускаемых в минуту (меньше или равно числу total active users). Установите это значение на уровне 100% от ожидаемого пикового трафика, чтобы пользователи попадали в очередь только тогда, когда это действительно нужно.

Длительность сессии

Продолжительность сессии улучшает пользовательский опыт двумя способами.

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

Однако они забыли добавить примечание к заказу или запросить чек. Пока их сессионный cookie-файл всё ещё действителен (в течение времени, указанного в session duration), они могут снова войти в приложение, не вставая заново в очередь зала ожидания.

Во-вторых, продолжительность сессии позволяет залу ожидания формировать динамический отток из вашего приложения (в дополнение к динамическому притоку). Сессионный cookie-файл пользователя истекает после периода бездействия, поэтому новые места могут освобождаться сразу же, как только появляется пространство, а расчётное время ожидания снижается и становится точнее.