Быстрый старт¶

В статье описан порядок установки и первоначальной настройки SmartBot Protection. Каждый шаг содержит ссылки на инструкции с подробным описанием действий.

Шаг 1. Установите ноду¶

Установите модуль на веб-сервер, через который проходит трафик защищаемых ресурсов. Для установки доступны пакеты и Docker-образ с инструкциями по развёртыванию.

Шаг 2. Настройте получение TLS-отпечатков¶

TLS-отпечаток используется для проверки по чёрному списку и привязки токена к соединению.

Выберите способ получения отпечатка в зависимости от того, где завершается TLS-соединение:

• На ноде.
• В stream-модуле без терминации TLS.
• На предшествующем балансировщике с передачей отпечатка в HTTP-заголовке.

Порядок настройки приведён в Получении TLS-отпечатков.

Шаг 3. Активируйте программный интерфейс и резолвер¶

Добавьте в конфигурацию защищаемого веб-сервера location для обслуживания программного интерфейса и укажите DNS-резолвер для проверки поисковых роботов.

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

Шаг 4. Назначьте типы проверки¶

Задайте для каждого location директивы, определяющие режим работы и тип проверки:

• Landing – для веб-страниц.
• Token Check – для программных интерфейсов.
• Fingerprint – для статических ресурсов.

Доступные значения и порядок настройки описаны в Настройке режимов работы SmartBot Protection.

Шаг 5. Обеспечьте встраивание агента¶

Нода автоматически встраивает скрипт агента в HTML-страницы. При необходимости скрипт можно добавить в код страниц вручную.

Порядок встраивания агента описан в Установке и настройке.

Шаг 6. Подключите Консоль управления¶

При подключении защищаемых ресурсов приложения автоматически появляются в разделе Управление Консоли управления.

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

Шаг 7. Введите защиту в работу¶

Сначала настройте новое правило в режиме Monitoring. В этом режиме срабатывания фиксируются, но запросы не блокируются.

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

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

Как убедиться, что защита работает¶

1. Откройте защищаемый сайт в браузере в режиме инкогнито. При типе проверки Landing должна кратковременно появиться страница проверки, после чего откроется сайт.

2. Выполните запрос к защищаемой странице из командной строки. В ответ должна вернуться страница проверки.

3. Выполните запрос к программному интерфейсу без токена. При типе проверки Token Check запрос должен быть заблокирован.

4. Проверьте заголовок X-Antibot-Response в ответе ноды:

   • LANDING – показана страница проверки.
   • BLOCK – запрос заблокирован.

   Этот заголовок позволяет проверить работу защиты из командной строки без использования браузера.

5. Убедитесь, что в Консоли управления появляются записи об активности ботов. Порядок просмотра событий описан в Мониторинге и анализе заблокированных запросов.