Правила та списки IP
Ухваліть рішення, доступні лише вам, і BotBlocker застосує їх до кожного візиту.
BotBlocker вирішує більшість візитів сам. Але деякі рішення потребують вашого знання сайту. Платіжний провайдер має завжди доходити до свого шляху зворотного виклику. Мережа надсилає лише спам. Інструмент партнера має User-Agent, схожий на бота. Правило — це місце, де ви записуєте таке рішення.
Кожне правило поєднує суб’єкт із дією. Суб’єкт — це те, що шукає BotBlocker: User-Agent, референт, шлях, адреса, країна, мережа або краулер. Дія — це те, що BotBlocker робить, коли знаходить його: пропускає відвідувача, надсилає його на сторінку перевірки або відмовляє йому. Правила діють до автоматичних перевірок, тож вони сильні. Додавайте їх обережно, пишіть коментар до кожного й давайте тимчасовим правилам дату завершення.

Сторінка Правила та списки IP. Відкрийте її через BotBlocker → Правила.
Одна сторінка, дев’ять списків
Сторінка має по вкладці для кожного виду правил. Вкладки Правила й Шляхи описано тут; інші вкладки мають власні сторінки:
| Вкладка | Що вона містить | Докладніше |
|---|---|---|
| Правила | Загальні правила, що збігаються з User-Agent, референтом, мовою, країною, назвою мережі та іншим | Ця сторінка |
| Шляхи | Правила, що збігаються з частиною запитаного URL | Ця сторінка |
| Довірені боти | Пошукові системи та інші краулери, які ви дозволяєте після перевірки їхнього походження | Довірені боти та ШІ-краулери |
| Перелік IPv4, Перелік IPv6 | Окремі адреси й діапазони адрес | Списки IP і проксі |
| Проксі | Мережі CDN і проксі, які можуть повідомляти справжню адресу відвідувача | Списки IP і проксі |
| ASN | Цілі мережі за їхнім номером мережі | Правила за країнами та ASN |
| LLM | ШІ-краулери, які BotBlocker підтримує актуальними за вас | Довірені боти та ШІ-краулери |
| GEO | Заблоковані країни | Правила за країнами та ASN |
Усі вкладки працюють однаково. Додати правило відкриває діалог для нового запису. Кнопка з олівцем у рядку редагує запис. Увімкнути/Вимкнути вимикає запис, не видаляючи його, тож ви можете ввімкнути його знову пізніше. Видалити прибирає його. Експорт зберігає список відкритої вкладки у файл JSON, а Імпорт завантажує такий файл. Імпорт додає лише записи, яких бракує, тож його можна запустити двічі без дублікатів. Експортуйте список, перш ніж робити велику зміну. Тоді у вас буде копія, до якої можна повернутися.
Панель поруч із вкладками показує Короткий посібник і Огляд таблиці. Огляд рахує записи в кожному списку за статусами Діючий, Вимкнено або Увага. Увага позначає записи, чия дата завершення минула. Вони більше ні з чим не збігаються.
П’ять дій
Кожне правило має одну з цих дій:
- Дозволити: відвідувач проходить, і BotBlocker припиняє перевіряти цей запит. Відвідувач також отримує cookie BotBlocker, тож наступні сторінки відкриваються без перевірки. Обмеження швидкості не рахує цей запит.
- Сірий: BotBlocker позначає відвідувача як підозрілого й продовжує звичайні перевірки. Для сірого відвідувача подальші перевірки суворіші.
- Темний: BotBlocker надсилає відвідувача на сторінку перевірки. Відвідувач, який уже пройшов перевірку, продовжує без нової. Див. Cookie та сесії.
- Блокувати: BotBlocker відмовляє в запиті. Відвідувач отримує сторінку блокування з кодом стану з розділу Блокування та відповіді.
- Постійний бан: те саме, що Блокувати, але без дати завершення. BotBlocker зберігає запис як Блокувати, що ніколи не спливає.
Порядок перевірок
BotBlocker не перевіряє всі списки одночасно. Він перевіряє їх один за одним, і перемагає перший список, який ухвалив рішення. Порядок такий:
- Відбитки TLS, якщо їх увімкнено. Поганий відбиток надсилає відвідувача на сторінку перевірки, і жодне правило Дозволити далі в цьому списку його не скасовує.
- Платіжні колбеки з повним обходом. Див. Платіжні колбеки. Частковий обхід проходить через списки нижче. Пропускається лише сторінка перевірки.
- ШІ-краулери на вкладці LLM.
- Краулери на вкладці Довірені боти.
- Перелік IPv4 або Перелік IPv6.
- Вкладка ASN.
- Вкладка Правила.
- Вкладка Шляхи.
- Обмеження швидкості, а після нього всі автоматичні перевірки.
Тож Дозволити у списку IP перемагає Блокувати на вкладці Шляхи. Усередині однієї вкладки вирішує пріоритет. Це число від 1 до 100, і BotBlocker перевіряє найнижче число першим. Дайте вузькому важливому правилу низьке число. Дайте широкому запасному правилу високе число.
Блокування країн на вкладці GEO працюють інакше. Вони діють у ранньому шарі, до початку цього порядку. Див. Правила за країнами та ASN.
Як збігається правило на вкладці «Правила»
Правило на вкладці Правила порівнює свої Дані з повним значенням відвідувача. Це не пошук частини тексту. Наприклад, правило Агент користувача з даними curl/8.4.0 збігається з відвідувачем, чий User-Agent точно curl/8.4.0. Воно не збігається з curl/8.5.0. Тож такі правила безпечні, але й вузькі. Якщо ви хочете ловити частину User-Agent, шляху чи назви краулера, використовуйте вкладку Шляхи або вкладку Довірені боти. Обидві шукають частину тексту.
Правила PTR є винятком із правила «повного значення». BotBlocker порівнює їх з останніми двома чи трьома частинами імені зворотного DNS відвідувача. Для відвідувача з crawl-1.example.com дані example.com збігаються.
Свіжа інсталяція BotBlocker уже має кілька правил Блокувати типу AS-ім’я на цій вкладці. Вони блокують кілька мереж, відомих спамом і ботовим трафіком. Ви можете вимкнути їх, якщо маєте причину.
Налаштування
Вкладка Правила і вкладка Шляхи мають кожна свій діалог. Їхні поля нижче.
Правила
Ці поля є в діалозі Додати загальне правило на вкладці Правила.
Тип
За замовчуванням: Агент користувача
Це те, що BotBlocker порівнює з Даними. Варіанти: Агент користувача, PTR, Референт, Мова, URI, HTTP Accept, Сторінка, AS-ім’я, AS-номер, Країна, Назва скрипта, ID Яндекс.Метрики і ID Google Analytics. Референт порівнює ім’я хоста сторінки, яка надіслала відвідувача. Країна використовує дволітерний код, наприклад DE. Два типи аналітики порівнюють ID відвідувача, який ці інструменти зберігають у cookie.
Щоб діяти на цілу мережу, вкладка ASN зазвичай простіша, ніж тип AS-ім’я чи AS-номер тут. Вона показує назви мереж із бази даних BotBlocker. Див. Правила за країнами та ASN.
Пріоритет
Позиція правила в порядку перевірок, від 1 до 100. BotBlocker перевіряє найнижче число першим, і перемагає перший збіг. Використовуйте низьке число для правила, яке має перемагати інші правила на цій вкладці.
Дані
Значення для зіставлення у форматі вибраного Типу. BotBlocker порівнює його з повним значенням відвідувача, тож копіюйте значення точно, наприклад із журналу відвідувачів у розділі Журнали трафіку й аудиту. Невелика різниця, як-от інший номер версії в User-Agent, зупиняє збіг.
Коментар
Нотатка для вас і для наступної людини, яка керує сайтом. Напишіть, чому ви додали правило й де побачили проблему. Через місяці ця нотатка скаже вам, чи правило ще потрібне.
Правило
За замовчуванням: Дозволити
Дія для відвідувача, що збігся: Дозволити, Сірий, Темний, Блокувати або Постійний бан. Розділ П’ять дій пояснює кожну.
Постійний бан ігнорує поле Закінчується. Якщо ви хочете блокування, яке закінчується саме собою, виберіть Блокувати й задайте дату завершення.
Закінчується
За замовчуванням: через один день
Дата й час, коли правило припиняє дію. Це поле треба заповнити. Після цього часу правило більше не збігається, і список позначає його як Увага. Для правила, яке має лишитися, задайте далеку дату в майбутньому або виберіть Постійний бан для блокування.
Шляхи
Ці поля є в діалозі Додати правило шляху на вкладці Шляхи. Правило шляху не має дати завершення. Воно лишається, доки ви його не вимкнете або не видалите.
Пріоритет
Позиція правила в порядку перевірок, від 1 до 100. BotBlocker перевіряє найнижче число першим. Правилу Дозволити для важливого шляху, як-от вебхук, потрібне низьке число, щоб ширше правило шляху не перемогло.
Правило
За замовчуванням: Дозволити
Дія для шляху, що збігся: Дозволити, Сірий, Темний, Блокувати або Постійний бан. На цій вкладці Постійний бан — це те саме, що Блокувати, бо правила шляхів ніколи не спливають.
Правило Дозволити для шляху пропускає кожного відвідувача цього шляху, також ботів. BotBlocker пропускає обмеження швидкості й усі подальші перевірки для нього. Використовуйте його для шляхів зворотних викликів і API, до яких мають доходити машини, а не для звичайних сторінок.
Правило Блокувати або Темний на шляху зворотного виклику може зламати платіж або вебхук. Див. Платіжні колбеки.
Шлях (URL)
За замовчуванням: порожньо
Частина шляху, яку треба шукати. BotBlocker шукає цей текст будь-де в запитаному шляху. Він не розрізняє верхній і нижній регістр і не враховує рядок запиту (частину після ?). Наприклад, /my-webhook/ збігається з /my-webhook/ і /shop/my-webhook/order. Використовуйте текст, унікальний для потрібної сторінки. Короткий текст, як-от /a, збігається з надто багатьма сторінками.
Коментар
Нотатка про те, чому існує правило шляху, наприклад назва сервісу, який викликає цей шлях.
Коли щось іде не так
- Справжньому відвідувачу відмовили, і ви не знаєте чому? Відкрийте журнал відвідувачів. Він показує правило, яке ухвалило рішення, наприклад «BLOCK By rule» або «BLOCK by IP rule». Див. Журнали трафіку й аудиту. Потім знайдіть цей запис на правильній вкладці.
- Правило не працює? Перевірте, що воно ввімкнене й що його дата завершення не минула. На вкладці Правила перевірте, що Дані — повне, точне значення. Потім перевірте порядок: список, що стоїть раніше в порядку, або правило з нижчим пріоритетом може перемогти першим.
- Платіж або вебхук перестає працювати після додавання правила? Пошукайте на вкладці Шляхи правило Блокувати або Темний для цього шляху й прочитайте Платіжні колбеки.
- Сервіс перестає працювати після видалення правила? Ймовірно, це було правило Дозволити. Додайте його знову з коментарем, потім перевірте сервіс.
- Ви заблокували себе? Скористайтеся посиланнями для відновлення в розділі Секрети аварійного відновлення. Не редагуйте базу даних вручну.