Документация

Как это работает Что происходит за 300 миллисекунд между запросом посетителя и отдачей страницы: кэш, обращение к движку, вердикт и что будет, если ответа нет. Логика фильтрации: как BotBan принимает решение Техническое описание для специалистов: где работает защита, какие признаки учитываются, как из них складывается решение и что не даёт задеть живого человека. Что будет с сайтом, если BotBan станет недоступен Короткий ответ: ничего, сайт продолжит работать без защиты. Длинный — как устроены таймаут, предохранитель и локальный кэш решений. Какие данные обрабатывает модуль и как это оформить Что именно модуль передаёт нам о посетителях вашего сайта, сколько это хранится и какую фразу добавить в свою политику конфиденциальности, чтобы всё было по закону.

Подключение PHP-модуля Подключение PHP-модуля одной строкой: решение принимается до того, как сайт начнёт собирать страницу. Требования, установка, проверка. Подключение JS-скрипта Подключение скрипта в head: работает на любом хостинге и конструкторе, без доступа к PHP, и видит признаки, которых серверу не видно. Подтверждение владения доменом Три способа подтвердить, что сайт ваш: файл на сайте, мета-тег на главной странице или TXT-запись в DNS. Ключи и код модуля появляются после подтверждения. Один сайт на нескольких доменах Сайт открывается под несколькими доменами из одной папки — например, в зонах .ru, .kz, .by и .рф. Как подключить такой сайт и что даёт список дополнительных доменов. Сайт за Cloudflare, nginx или балансировщиком Сайт за Cloudflare, nginx или балансировщиком: как передать модулю настоящий адрес посетителя, а не адрес прокси, и чем опасна ошибка. Публичный API Публичный API BotBan: токены, лимиты, чтение статистики, журнала визитов и списка адресов ботов из своих систем. С примерами запросов. Список для файрвола и fail2ban Как закрыть повторяющиеся адреса ботов на самом сервере — в ipset, nginx, .htaccess или через fail2ban, — что попадает в список, чего в нём не бывает и как поставить автообновление.

Пороги: что означает балл Как устроен балл подозрительности, что означают пороги проверки и блокировки и как выбрать значения, при которых покупатели не страдают. Белые списки: кого защита не проверяет и как это настроить Что заносить в белый список обязательно: вебхуки платёжных систем, обмен с 1С, мониторинг. И почему поисковики туда добавлять не нужно.

Нагрузка на сервер: что показывает карточка Откуда берутся цифры процессорного времени на дашборде, как считается «сэкономлено» и почему мы не показываем общую загрузку сервера. Карточка «Доступность» в кабинете: как читать простои и настроить уведомления Раз в минуту BotBan открывает главную страницу сайта и пишет, если она не открывается: что считается простоем, как выглядят наши запросы и почему защита их пропускает. Обзор кабинета Из чего состоит панель управления: разделы, выбор сайта и периода, тема оформления и где что искать в первые пять минут. Дашборд: что означают цифры Четыре метрики, график по времени, самые частые причины срабатывания и адреса, к которым чаще всего обращаются боты. Как читать сводку и что в ней важно. Сайты: добавление, ключи и режим защиты Как добавить сайт, что означают способы подключения, где взять ключи и сниппет, как перевыпустить секрет, включить блокировку, открыть сайт другому аккаунту или передать его. Журнал визитов: как читать решения Фильтры по периоду, вердикту и адресу, разница между «вердиктом» и «применено», объяснение по каждому визиту и кнопка «это был не бот». Настройки защиты: пороги, действия, списки Что означает каждый блок на странице настроек, какие значения безопасны, почему часть изменений требует подтверждения и как вернуть прошлую версию. Раздел «Реклама»: клики ботов, адреса для исключения и жалоба Как BotBan узнаёт клики по рекламе, сколько из них сделали боты, как выгрузить их адреса в Директ и Google Ads и собрать отчёт для обращения в поддержку рекламной системы. Уведомления: почта и Telegram О каких событиях кабинет сообщает сам, как подключить Telegram кодом через бота и что делать с уведомлением, когда оно пришло. Тариф, оплата и лимиты Как оплатить и продлить тариф картой, через СБП и другие способы ЮKassa, как включить и выключить автопродление, как пересчитывается остаток при смене тарифа, как вернуть деньги, как считаются визиты и что будет при исчерпании лимита. Аккаунт: пароль, двухфакторная защита, API-токены Как сменить почту и пароль, включить вход по коду из приложения, выпустить и отозвать токен для публичного API и что делать при утечке. Поддержка: как написать, чтобы ответили быстро Как создать обращение, что приложить, как устроена переписка и срочность, и какие вопросы решаются без нас. Раздел «Бюджет на ботов»: как подключить Метрику и Директ и что он показывает Как подключить Яндекс Метрику и Директ к BotBan, увидеть расход на клики ботов по кампаниям, фразам и площадкам, исключить площадки одной кнопкой и собрать сегмент ботов для Директа.

Хостинг пишет о нагрузке, хотя защита включена Почему цифры хостинга и журнал BotBan не сходятся: что считает хостинг, что видит модуль, и как на самом деле снизить нагрузку от роботов. Меня самого заблокировало Защита сработала на вас или на клиенте: как снять блок за минуту, найти причину в журнале и настроить так, чтобы это не повторилось. Перестали приходить уведомления об оплате Платёжная система или CRM перестали доставлять уведомления после включения защиты: как найти адреса в журнале и внести их в исключения. Поисковик перестал видеть сайт Страницы выпали из индекса или робот жалуется на ошибки: как за две минуты проверить в журнале, что поисковик проходит свободно. Сайт стал медленнее Сколько миллисекунд добавляет модуль на самом деле, откуда берётся задержка, как её измерить и уменьшить через кэш и таймаут.