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

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

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

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

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

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