Параметры конфигурации ноды¶
Параметры ноды задаются в конфигурационном файле формата JSON. Изменения применяются без перезапуска. Файл конфигурации, а также доставляемые файлы правил и списков перечитываются автоматически.
Параметры, которые изменяются в ходе эксплуатации, включая срок жизни токена, наборы параметров, правила и списки, задаются в Консоли управления и передаются на ноду при применении конфигурации. Конфигурационный файл определяет поведение механизма проверки.
Порядок изменения и применения настроек описан на странице Управление.
Cookie и токен¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
cookie.name | wa_e55eb591 | Имя cookie с токеном |
cookie.secure | true | Флаг Secure в устанавливаемой cookie |
cookie.max_age | 31536000 | Срок хранения cookie, секунд |
cookie.domains | Пусто | Домены установки токена. При пустом значении токен устанавливается на текущий домен. При двух и более значениях используется режим нескольких доменов |
token.key | Задаётся при установке | Ключ шифрования токена по умолчанию. Смена ключа делает недействительными все выданные токены. Они перевыпускаются при следующем прохождении проверки |
token.ttl | 120 | Срок жизни токена по умолчанию, секунд |
Режим нескольких доменов описан в Токене доступа и проверке запросов.
Для приложений, управляемых через Консоль, ключ шифрования и сроки задаются наборами Cookie. Порядок настройки описан на странице Управление.
Страницы проверки и блокировки¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
landing_page | html/landing.html | Шаблон страницы проверки |
landingjs | html/landing.js | Агент страницы проверки |
landing_http_status | 403 | Код ответа страницы проверки |
block_page | html/block.html | Шаблон страницы блокировки |
block_http_status | 403 | Код ответа страницы блокировки |
Порядок изменения шаблонов описан в Кастомизации Landing и Кастомизации страницы блокировки.
Проверка браузера и пороги¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
registration.signals_file | signals | Файл с перечнем сигналов браузерного окружения и их весами |
registration.signals_file_check_period | 500 | Период перечитывания файла сигналов, мс |
registration.bad_score | 100 | Порог суммарного веса сигналов, при превышении которого клиент отклоняется |
registration.captcha_weight | 10 | Порог, начиная с которого запрашивается CAPTCHA |
registration.landing_token_ttl | 15 | Срок жизни токена страницы проверки, секунд |
registration.initial_token_score_max / registration.initial_token_score_min | 100 / 60 | Границы начальной накопительной оценки при выдаче токена |
registration.captcha_solved_bonus | 10 | Бонус накопительной оценки за решённую CAPTCHA |
Пороги применяются к сигналам браузерного окружения. Порог CAPTCHA определяет, какие сеансы переходят к интерактивной проверке. Подробнее – Адаптивные действия.
Веса сигналов браузерного окружения¶
Файл registration.signals_file содержит перечень сигналов и их веса. Вес определяет вклад каждого сигнала в суммарную оценку.
Изменения файла применяются автоматически. Снижение веса уменьшает вклад сигнала, а нулевой вес исключает его из расчёта.
Изменяйте веса вместе с порогами bad_score и captcha_weight и проверяйте результат в режиме Monitoring.
Ориентиры по весам:
- 100 – однозначные признаки автоматизации: управляемый браузер, Selenium, Puppeteer, Electron, окружение Node.js, подменённые свойства окружения.
- 10 – сигналы подозрения: поддельные сборки браузеров, нестандартные платформа и оборудование, программный рендеринг. По отдельности эти признаки не являются основанием для блокировки.
Поведенческий анализ¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
analyze.interval | 30 | Интервал вызова поведенческого анализа агентом, секунд |
analyze.analyzejs | html/analyze.js | Файл агента поведенческого анализа |
CAPTCHA¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
altcha.hmac | Задаётся при установке | Ключ подписи заданий CAPTCHA |
altcha.max_number | 100000 | Верхняя граница сложности задания |
altcha.ttl | 300 | Срок жизни задания, секунд |
altcha.salt_length | 16 | Длина случайной части задания |
Списки и белый список ботов¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
blacklists.tls.path | blacklist_tls | Файл чёрного списка отпечатков TLS |
blacklists.tls.field_map | ja4: x-ja4-fingerprint,ja4 | Заголовки запроса, из которых извлекается отпечаток. Указываются тип отпечатка и список имён заголовков через запятую |
blacklists.tls.file_check_period | 500 | Период перечитывания файла, мс |
blacklists.useragent.path | blacklist_useragent | Файл чёрного списка User-Agent |
blacklists.useragent.file_check_period | 500 | Период перечитывания файла, мс |
good_bots.good_bots_file | well_known_bots | Файл белого списка поисковых роботов |
good_bots.ttl / good_bots.ttl_block | 24 / 1 | Срок кеширования вердиктов допуска и блокировки, часов |
good_bots.cache_entries | 131072 | Размер кэша вердиктов |
good_bots.ipv6_block_prefix | 64 | Префикс IPv6, на который распространяется блокировка |
Настройка передачи TLS-отпечатков в заголовках описана в Получении TLS-отпечатков.
Содержимое списков управляется в Консоли управления и доставляется на ноду. Ручное редактирование файлов не предусмотрено.
Порядок работы со списками описан в Управлении сигнатурами.
Правила и настройки приложений¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
route_rules.file_name | node_rules | Файл доставленных правил и настроек приложений |
route_rules.file_check_period | 500 | Период перечитывания файла, мс |
Шифрование и сравнение отпечатков¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
encryption_keys | Набор ключей поставки | Ключи расшифрования тел запросов агента и мобильного контура. Задаются в формате «идентификатор – путь к PEM-файлу». Генерируются скриптом из поставки |
tls_fingerprint_compare | ja4: первые 22 позиции | Маска сравнения TLS-отпечатка в токене с отпечатком запроса. Символ 1 означает сравнение позиции, 0 – игнорирование, = – полное сравнение |
Мобильный контур¶
| Параметр | Назначение |
|---|---|
mobile.enabled | Включение программного интерфейса мобильных приложений |
mobile.token.ttl | Срок жизни токена, секунд |
mobile.analyze.interval | Интервал вызова анализа, секунд |
mobile.registration.bad_score | Порог блокировки по суммарному весу признаков |
Порядок включения и значения параметров описаны в Защите мобильных приложений.
Память и журналы¶
| Параметр | По умолчанию | Назначение |
|---|---|---|
shared_memory.tls_blacklist | true | Размещение чёрного списка TLS в разделяемой памяти воркеров |
shared_memory.user_agent_blacklist | false | Размещение чёрного списка User-Agent в разделяемой памяти воркеров |
shared_memory.user_agent_goodbots | false | Размещение белого списка ботов в разделяемой памяти воркеров |
antibot_api_logs.dir | /var/log/antibot_api | Каталог журнала программного интерфейса ноды |
antibot_api_logs.level | 30 | Уровень детализации журнала |
antibot_api_logs.max_file_size_per_worker | 10485760 | Размер файла журнала до ротации, байт |
antibot_api_logs.max_rotate_per_worker | 10 | Количество хранимых ротаций |
Назначение журналов и порядок работы с ними описаны в Журналах и метриках ноды.