Диагностика проблем¶

Если SmartBot Protection блокирует обычные запросы к вашему приложению, начните с журнала Боты в Консоли управления. В нём указаны основание блокировки, отпечатки клиента и идентификаторы запроса и сессии. Подробнее о работе с журналом см. в статье Мониторинг и анализ заблокированных запросов.

Как выяснить причину блокировки¶

Скопируйте Request ID со страницы блокировки. Если идентификатор недоступен, запишите примерное время блокировки и адрес страницы.
Откройте раздел Боты в Консоли управления и найдите запись по идентификатору запроса или сессии. Если идентификатора нет, ищите по времени блокировки и адресу страницы.
Откройте запись и посмотрите основание блокировки.
Найдите свою ситуацию в таблице ниже и выполните предложенные действия.

Определение масштаба проблемы¶

Проверьте, какие запросы к вашему приложению блокируются:

Отдельный запрос или сеанс. Проверьте соответствующую запись в журнале.
Запросы из одной сети или с одинаковым окружением. Проверьте настройки сети, программного обеспечения и браузера, общие для этих запросов.
Весь трафик. Проверьте последние изменения настроек. Если блокировки начались сразу после изменения конфигурации, верните предыдущую версию и выясните, какая настройка вызвала проблему.

Порядок возврата к предыдущей конфигурации описан на странице Управление.

Типовые ситуации¶

Ситуация	Что происходит	Что делать
При проверке приложения вы видите блокировки обычных запросов в отдельных сеансах	Один из уровней защиты срабатывает при нестандартном окружении	Проверьте основание блокировки в журнале. Если блокировки обычных запросов повторяются в разных сеансах, скорректируйте настройки сработавшего механизма. Подробнее – Первый запуск и ввод в работу
Количество блокировок выросло после изменения настроек	Изменённое правило или параметр может блокировать обычные запросы к приложению	Верните предыдущую версию конфигурации: Использовать как текущий → отправка на ноды. Порядок действий описан на странице Управление
Рост количества блокировок с основанием Токен не расшифрован	Клиенты предъявляют изменённые или подменённые токены. Это может указывать на попытки обхода защиты	Проверьте, не совпадает ли начало блокировок с изменением ключа шифрования. После смены ключа ранее выданные токены становятся недействительными до перевыпуска
После длительной работы со страницей вы видите блокировку с основанием Токен устарел	Срок действия токена истекает во время длительной работы со страницей	Увеличьте срок жизни токена в наборе Cookie. Порядок настройки описан на странице Управление
В журнале для части запросов указано основание Токен другого клиента (HTTP Fingerprint)	Состав заголовков запроса изменяется при прохождении трафика, например через корпоративные прокси или ускорители	Сопоставьте заблокированные запросы по сети и программному обеспечению. Проверьте изменение заголовков при прохождении трафика
Отсутствуют TLS-отпечатки в журнале	TLS-отпечаток не передаётся на ноду	Проверьте схему получения отпечатка. Сбор может быть не настроен или заголовок передаётся не на всех путях. Подробнее – Получение TLS-отпечатков
Страница проверки отображается повторно	Токен не сохраняется браузером	Проверьте, не отключены ли cookies, не используется ли режим инкогнито и настроен ли параметр `cookie.domains` при работе с несколькими доменами. Подробнее – Токен доступа и проверка запросов
CAPTCHA не отображается	На странице проверки отсутствует элемент виджета	Проверьте, что при кастомизации Landing не были удалены служебные элементы. Подробнее – Кастомизация Landing
Мобильное приложение получает блокировки на все запросы	Мобильный контур не включён или цикл проверки в приложении не завершается	Проверьте настройки мобильного контура и порядок взаимодействия с программным интерфейсом. Подробнее – Защита мобильных приложений
Поисковый робот заблокирован как имитация	Робот не подтвердил принадлежность к сетям заявленной поисковой системы	Проверьте DNS-записи сети робота. Подтверждённого робота добавьте в белый список. Подробнее – Проверка поисковых роботов
Нода возвращает код `503` на отдельные запросы	Сбой DNS-резолвера при проверке поискового робота или обращение к программному интерфейсу при выключенном антиботе	Проверьте доступность DNS-резолвера и активацию модуля. Подробнее – Настройка SmartBot Protection и Журналы и метрики ноды

Если причину не удалось определить¶

Попробуйте повторить действие, при котором возникла блокировка. Найдите соответствующую запись в журнале Боты и сохраните данные для диагностики:

Request ID.
User ID.
Основание блокировки.
Отпечатки клиента.
Приложение.

Для дополнительной диагностики используйте локальные журналы ноды: журнал доступа с результатами проверок и журнал antibot_api. Они позволяют найти обращение по тем же идентификаторам.

Порядок работы с локальными журналами описан в Журналах и метриках ноды.

Если после проверки журналов причина остаётся неясной, обратитесь в техническую поддержку. Опишите, какое действие приводит к блокировке, и приложите собранные данные.