Можливості та конектори WordPress
Дозвольте ШІ-асистентам та іншим інструментам ставити BotBlocker запитання або навіть блокувати адресу — з точно тим доступом, який ви виберете.
Нові версії WordPress мають Abilities API. З ним плагін може публікувати іменовані дії, які називають можливостями. Інше програмне забезпечення може знаходити ці дії й викликати їх: REST-клієнти, інструменти автоматизації та ШІ-асистенти через MCP. Тож ви можете запитати асистента «чи заблоковано цю IP?» і отримати відповідь від BotBlocker, не відкриваючи Майстерню.
Це корисно, але також відчиняє двері. Можливість читання нешкідлива. Можливість, яка блокує адресу, змінює ваш захист. Тому кожна можливість BotBlocker вимкнена за замовчуванням. Головний перемикач керує всією функцією, а кожна можливість має власний перемикач. Ви публікуєте лише ті дії, яким довіряєте, і нічого більше.

Панель WP Abilities API. Відкрийте її через BotBlocker → Інтеграції → WP Abilities API.
Коли функція вимкнена, можливостей не існує
Коли головний перемикач вимкнений, BotBlocker нічого не реєструє. Його можливості не показуються в списку можливостей, у REST, у MCP або в кінцевих точках запуску. Клієнт не може викликати те, чого не існує. Це безпечний стан, і він початковий.
Коли ви вмикаєте головний перемикач, видимими стають лише можливості з увімкненим власним перемикачем. Якщо ваша версія WordPress не має Abilities API, BotBlocker нічого не реєструє, навіть із усіма перемикачами.
Перемикання цілої групи одразу
Перемикачів багато, тож над списком у лівій колонці є три кнопки. Вони змінюють перемикачі на сторінці; нічого не зберігається, доки ви не натиснете Зберегти. Наведіть на кнопку, щоб побачити, що вона робить.
- Увімкнути всі вмикає головний перемикач і кожну можливість BotBlocker. Можливості аддонів не зачіпаються, бо їхні перемикачі в налаштуваннях аддона.
- Лише читання вмикає головний перемикач, вимикає всі можливості й потім вмикає групу лише для читання. Це звичайна відправна точка: клієнт може ставити запитання й не може змінити захист.
- Вимкнути всі вимикає головний перемикач і всі можливості. Клієнти більше нічого не бачать від BotBlocker.
Викликати їх можуть лише адміністратори
Кожній можливості BotBlocker потрібна здатність manage_options, тож викликати її може лише обліковий запис адміністратора. Клієнт (асистент або інструмент) діє від імені облікового запису, під яким він входить. Тож ставтеся до клієнта, який може викликати ці можливості, як до людини з вашим паролем адміністратора. Дайте йому обліковий запис і облікові дані, які ви контролюєте.
Почніть із читання, зміни додайте пізніше
Можливості згруповані:
- Лише для читання — можливості дають тільки інформацію. Вони нічого не можуть змінити. Почніть із них.
- Керування — можливості додають, оновлюють або видаляють правила IP, службові дані та встановлені аддони. Вмикайте їх лише тоді, коли маєте для них чітке завдання.
- Керування захистом (руйнівні) — можливості змінюють ваші налаштування захисту: вмикають або вимикають захист, перемикають безпечний режим чи режим CAPTCHA та очищають кеш. Вони діють як адміністратор у Майстерні.
- Сканер шкідливого ПЗ (PRO) — можливості запускають сканування або читають його результати. Ви бачите їх, лише коли аддон Сканер шкідливого ПЗ активний.
Можливості лише для читання
Крім старіших можливостей статусу, IP і діагностики, група лише для читання тепер включає:
- Список правил IP (
botblocker/list-ip-rules) перелічує правила файрвола з фільтрами за IPv4/IPv6, типом правила, текстом пошуку й пагінацією. Використовуйте його, щоб оглянути списки, не відкриваючи Майстерню. - Отримати заблоковані IP-адреси (
botblocker/get-blocked-ips) повертає лише адреси, які активно заблоковані. Прострочені правила пропускаються. - Отримати останні події (
botblocker/get-recent-events) повертає кількість блокувань, дозволів, подій CAPTCHA та проксі-подій за кожен проміжок часу. Він навмисно не повертає окремих IP-адрес і user agent. - Отримати налаштування (
botblocker/get-settings) повертає несекретні налаштування BotBlocker. Іменована група дає дібраний набір, групаall— усі налаштування, які зберігає плагін. Облікові дані та персональні дані повідомляються лише як булеве значення всерединіredacted; саме значення ніколи не повертається.writableперелічує кожен ключ, який приймає Зміна налаштування-перемикача, незалежно від запитаної групи. - Отримати стан CAPTCHA (
botblocker/get-captcha-state) показує активний режим CAPTCHA, час очікування й доступні на цьому сайті режими. Режим може бути недоступним без GD або без ключів reCAPTCHA. - Запустити підсумок самоперевірки (
botblocker/run-self-test) повертає той самий підсумок, який показує самоперевірка, не запускаючи нову перевірку й не пишучи в журнал плагіна. - Перевірити кілька IP-адрес (
botblocker/check-ips) перевіряє до 20 адрес за один виклик, тож інструменту автоматизації не потрібен окремий запит на кожну адресу.
botblocker/check-ip перевіряє збережені правила IP і гарячі блокування з тим самим порядком пріоритету, що й живий рушій: ігнорує прострочені правила та службові рядки для локальних і серверних адрес і повідомляє про активне гаряче блокування. Відповідь містить source, matched_rules, усі правила, що збіглися, і deciding_rule. Вона не враховує сигнатури ботів, geo, ASN і ліміти частоти; для повного прогнозу використовуйте Симуляцію запиту, а повний список правил, що збіглися, — Отримати правила IP.
Діагностика рішень
Ці можливості пояснюють, чому запит заблоковано, відправлено на перевірку або пропущено. Вони лише читають стан.
- Симуляція запиту (
botblocker/simulate-request) приймає IP-адресу й відбиток (шлях, user agent, referer, мову, JA3 або JA4, cache pass) і повертає передбачене рішення, код причини, правило-переможець, сигнал бота, категорію TLS, geo та ASN, поточний стан лімітів і шар, який вирішив. Нічого не записується, лічильники не зростають, зовнішні хости не викликаються. Передбачення враховує пріоритет правил, сигнатури ботів і дані TLS, але не повторює всі перевірки рушія. Розбіжність варто розібрати через Трасування рішення. - Трасування рішення (
botblocker/get-decision-trace) читає останню збережену подію відвідувача за IP-адресою або заcidклієнта (не обидва одразу) й повертає збережене рішення, числовий код причини, правила IP, які збіглися, geo та ASN з події, замасковану особистість edge і поточний стан лімітів. - Стан лімітів (
botblocker/get-rate-limit-state) повертає бакети IP і підмережі з тими самими ключами, що в обмежувача, вікно, чинні пороги блокування й CAPTCHA, тиск підмережі та активний бан за ліміт. Читання не додає влучання, тому повторний виклик дає ті самі числа. - Відбиток запиту (
botblocker/get-request-fingerprint) показує, як BotBlocker бачить клієнта: нормалізовану IP-адресу, родину адреси, родину й хеш user agent, заголовки JA3 або JA4, geo та ASN, мову й протокол. Довіру до TLS-заголовка показано окремо; для заголовка без довіреного проксі вонаfalse. Полеpeer— це транспортна адреса поточного запиту; для діагностики воно повертається без маски. - Цілісність даних (
botblocker/get-data-integrity) перелічує runtime-файли в теці даних з розміром, часом зміни у форматі ISO 8601 і, зinclude_content_hashes, хешами SHA-256. Показує відсутні та зайві файли й стан runtime-файлу налаштувань. Плагін не зберігає еталонні хеші, томуokозначає лише, що файл існує й читається; порівняння хешів не виконується. - Збіг сигнатури бота (
botblocker/get-bot-signature-match) звіряє user agent зі згенерованим списком сигнатур і списком пошукових систем та повертає сигнатуру, тип списку, дію й токени перевірки. - Збіг TLS (
botblocker/get-tls-match) шукає відбиток JA3 або JA4 і порівнює очікувану родину user agent з родиною з наданого user agent. Рукостискання не виконується. - Geo та ASN (
botblocker/get-geo) повертає країну, континент, ASN, організацію й CIDR з локальної бази ASN. VPN, Tor і хостинг лишаютьсяfalse, якщо локальна база не може їх визначити. - Стан cache pass (
botblocker/get-pass-state) перевіряє cookie: формат, термін і підпис. Підпис прив'язаний до id відвідувача й IP, тому передайтеuidтаip; без них відповідь кажеbindings_missing, а не вгадує. Секрет і підпис не повертаються. - Стан перевірки (
botblocker/get-challenge-state) повертає режим CAPTCHA,wait_seconds,retry_limitіretries_left, провайдера та його доступність, запасний режим, ознаку тихого режиму й стабільні коди проблем. Передайтеhits, щоб отримати залишок спроб для цього лічильника;retries_leftдорівнює null, колиretry_limit— 0. - Збіг правил (
botblocker/get-rule-match) повертає всі правила IP і користувацькі правила, що підходять під відбиток, за пріоритетом, і правило-переможець. - Стан шарів (
botblocker/get-layer-state) показує, який шар відповідає: Early Init з ознакою роутера у wp-config і хешем роутера, хеш файлу MU-плагіна, основний щит, шлюзи кешу й geo, стан авто-довіри, знайдені конфлікти та версії. - Довіра до edge (
botblocker/get-edge-trust) показує особистість поточного запиту, записи, яким довіряють автоматично, та за флагомinclude_mapкарти proxy, bot-network, auto і shared;maps_includedкаже, чи їх прочитано. Адреси завжди маскуються. - Докази edge (
botblocker/get-edge-evidence) читає рядки доказів для недовірених edge, пороги підвищення та хеші клієнтів за флагом; адреси й PTR маскуються. - Пояснення рішення про бан (
botblocker/explain-ban-decision) проганяє справжній гейт банів для цілі без запису і пояснює, чи був би бан і чому; PTR цілі не резолвиться. - Експорт діагностики (
botblocker/export-diagnostics) збирає в одну відповідь налаштування без секретів, цілісність файлів, стан шарів і останнє рішення. У налаштуваннях замість значення стоїть буквальна позначка[redacted].
Керування для тестів
Ці можливості потрібні на контрольованому стенді. Вони вимагають підтвердження, підтримують dry_run і обмежені за частотою.
- Скидання бакета лімітів (
botblocker/reset-rate-limit) видаляє бакети IP і підмережі для адреси. Правил, налаштувань і банів не торкається. Підтвердження:RESET. - Посів тимчасового тестового правила (
botblocker/seed-test-rule) створює короткоживуче правило. Коментар має починатися зbbcs-harness:, аexpires_inобов'язковий; решту відхилено. Підтвердження:SEED. - Очищення тестових правил (
botblocker/clear-test-rules) видаляє лише правила з коментаремbbcs-harness:і не чіпає правила користувача. Підтвердження:CLEAR. - Зміна налаштування-перемикача (
botblocker/set-setting) вмикає або вимикає одне булеве налаштування захисту тим самим шляхом збереження, що й Майстерня. Перелікkeyу схемі можливості містить усі прийнятні ключі. Підтвердження:SET. На окремій сторінці описано ключі та показано приклади викликів.
Можливості аддонів
Активні аддони оголошують свої можливості, а їхні перемикачі лежать у налаштуваннях аддона.
- Malware Scanner:
botblocker/malware-scan-bufferперевіряє base64-буфер рушієм сигнатур і нічого не записує;botblocker/malware-get-coverageпоказує області, ліміти, розширення й стан бази сигнатур. - Security Headers:
botblocker/get-effective-headersпоказує набір заголовків і як він застосовується до дозволених, заблокованих, перевірочних, 404, REST і адмін-відповідей. - Page Cache:
botblocker/get-cache-stateпоказує кешованість, влучання, ключ, варіант і вимогу cache pass для URL;botblocker/purge-url-cacheчистить один URL і вимагаєPURGE. - Hide Admin URL:
botblocker/get-hidden-routesпоказує слаг входу, адресу входу й механізм приховування. - Hide WordPress:
botblocker/get-wp-hidden-routesпоказує стан readme, debug.log і htaccess. - Anti-Spam:
botblocker/classify-commentоцінює коментар без збереження. Локальна перевірка працює за замовчуванням;use_classifierнадсилає текст у редакційний сервіс із налаштувань аддона. - Form CAPTCHA:
botblocker/get-form-challenge-stateпоказує TTL, залишок спроб і прив'язки для ідентифікатора перевірки. - 404 Guard:
botblocker/get-404-windowпоказує лічильник, поріг, вікно, дію й блокування для IP. - Feed Guard:
botblocker/get-feed-rulesпоказує режим анонсу, атрибуцію, noindex і закриті типи фідів. - Behavioral Analysis:
botblocker/get-behavior-scoreпоказує бал, пороги, сигнали й збережений рівень репутації IP. - XML-RPC Tunnel:
botblocker/get-tunnel-stateпоказує стан тунелю, розмір списку дозволених і пропуск для IP. - Firewall Export:
botblocker/preview-exportзбирає текст експорту одного формату, адреси за замовчуванням маскуються. - Early Init:
botblocker/get-early-layer-stateпоказує синхронізацію, викладку роутера, карту сайтів і конфлікти.
Керування правилами IP
- Створити або оновити правило IP (
botblocker/upsert-ip-rule) приймає IP-адресу або діапазон CIDR і тип правила:allow,block,grayабоdark. Відповідь повідомляєcreated,previous_rule,changedіapplied. - Видалити правило IP за id (
botblocker/delete-ip-rule) видаляє одне правило за його числовим id. Номери унікальні лише в межах однієї родини адрес, тому передайтеfamily(ipv4абоipv6), якщо такий номер є в обох; інакше виклик відхиляється зability_ambiguous_rule_id.
Обидві можливості відмовляються змінювати або видаляти правила лише для читання, як-от рядки адреси адміністратора чи сервера. Вони також відмовляються перетворювати правило дозволу на блокування або блокувати поточну чи серверну IP, якщо ви не передасте force: true. Старіші можливості block-ip і unblock-ip продовжують працювати й отримали ті самі запобіжники.
Усі відповіді з правилами використовують однакові поля: id, family, rule, value, priority, expires, expired, readonly і comment, де value — адреса або діапазон CIDR. Номер правила унікальний лише в межах однієї родини адрес.
- Скинути кеш PTR (
botblocker/reset-ptr-cache) видаляє збережені відповіді зворотного DNS і очищає кеш плагіна, тому наступні перевірки знову запитують імена. Правила, налаштування й бани не змінюються. Підтвердження:RESET, підтримуєdry_run.
Керування аддонами
Ці можливості керують встановленими аддонами так само, як сторінка «Аддони». Потрібні права manage_options, діє обмеження швидкості, підтримується dry_run.
- Встановити або оновити аддон (
botblocker/install-addon) завантажує пакет із каталогу BotBlocker за slug, перевіряє ZIP і маніфест, встановлює або замінює аддон у runtime-каталозі. Потрібна активна ліцензія PRO і підтвердженняINSTALL. Аддон не вмикається: після встановлення викличте Увімкнути або вимкнути аддон. URL каталогу має бути у списку дозволених. - Увімкнути або вимкнути аддон (
botblocker/set-addon-state) активує чи деактивує встановлений аддон тим самим життєвим циклом, що й сторінка «Аддони», і надсилаєbbcs_addon_toggled. Увімкнення несумісного з ядром аддона відхиляється зability_incompatible. Підтвердження:ENABLEабоDISABLE. - Видалити встановлений аддон (
botblocker/delete-addon) спершу вимикає активний аддон, потім виконує життєвий цикл видалення й прибирає каталог аддона. Підтвердження:DELETE. Видалення не можна скасувати іншою можливістю; спершу зробітьdry_run.
Встановлення й видалення відхиляються в локальному режимі аддонів і при DISALLOW_FILE_MODS. Статус аддонів показує, що встановлено й що активне.
Керування захистом (руйнівні)
Ці можливості потребують значення підтвердження й обмежені за швидкістю.
- Увімкнути або вимкнути захист (
botblocker/set-protection) вмикає чи вимикає захист BotBlocker так само, як перемикач у Майстерні, включно з файлом середовища виконання, який використовується на найраннішому шарі. Значення підтвердження —ENABLEабоDISABLE. - Встановити безпечний режим (
botblocker/set-secure-mode) перемикається міжfrontendіfull. Повний режим також перевіряє адмін-зону WordPress. Значення підтвердження —FRONTENDабоFULL. - Встановити режим CAPTCHA (
botblocker/set-captcha-mode) перемикає режим CAPTCHA і, необов’язково, час очікування. Режим, недоступний на цьому сайті, відхиляється з помилкою, а не тихо перемикається на запасний. - Очистити файловий кеш плагіна (
botblocker/clear-cache) очищає файловий кеш після ручних змін правил або даних. - Зняти авто-довіру edge (
botblocker/remove-edge-trust) видаляє один запис авто-довіри за маскою, перепідписує файл і пишеedge.trust.removedв аудит. Відповідь повідомляєdeletedіremaining. Підтвердження:REMOVE, підтримуєdry_run.
Підтвердження та пробні запуски
Руйнівній можливості потрібне значення confirm, що відповідає дії, наприклад DISABLE, DELETE, UPSERT, CAPTCHA, COUNTRY, ASN, UPDATE або PRESET. Без нього або з токеном, що не відповідає цільовому стану, виклик відхиляється з ability_confirmation_required, і нічого не змінюється. Клієнт має надсилати значення лише після того, як вирішив, що зміна навмисна. set-protection приймає ENABLE лише з enabled: true, а DISABLE лише з enabled: false; set-secure-mode приймає FRONTEND лише з mode: "frontend", а FULL лише з mode: "full".
block-ip, unblock-ip, set-protection, set-secure-mode, set-captcha-mode, upsert-ip-rule, delete-ip-rule, delete-ip-rules, set-country-rule, set-asn-rule, update-threat-data, reset-rate-limit, reset-ptr-cache, seed-test-rule, clear-test-rules, remove-edge-trust, apply-preset, set-setting, set-security-headers-domains, clear-cache, install-addon, set-addon-state, delete-addon і load-license-from-cloud приймають dry_run: true. Кожна відповідь містить dry_run і applied. Під час пробного запуску applied дорівнює false, а факти на кшталт created, deleted, restored_toggles і нового номера правила лишаються нейтральними; поля, що описують стан (previous*, found, remaining, current, added, removed), заповнюються проєкцією. protection_enabled завжди показує реальний поточний стан. Використовуйте пробний запуск перед справжнім викликом.
Виклики користувачів, які ввійшли, записуються в журнал аудиту з назвою можливості, викликачем, IP-адресою, user agent, результатом і тривалістю, включно з викликами, відхиленими перевіркою дозволів, словом підтвердження чи лімітом частоти. Виклики, відхилені через некоректні вхідні дані, не записуються. Секрети не записуються.
Обмеження частоти — захист від випадкових циклів, а не межа безпеки. Межі — перевірка дозволів і слово підтвердження.
Помилки
Відхилений виклик повертає помилку WordPress, яку MCP-клієнт отримує як невдалий виклик із текстом повідомлення. Коди можливостей та їхні HTTP-статуси: ability_invalid_input (400), ability_confirmation_required (400), rest_forbidden (403), rest_not_logged_in (401), ability_forbidden (403), ability_not_found (404), ability_readonly_rule (409), ability_allow_downgrade_requires_force (409), ability_self_block_requires_force (409), ability_ambiguous_rule_id (409), ability_mode_unavailable (409), ability_incompatible (409), ability_unavailable (409), ability_rate_limited (429), ability_download_failed (502), ability_backend_unavailable (503) і ability_execution_failed (500). Сприймайте код як стабільний, а повідомлення — як текст для людини.
Запит, який не відповідає JSON-схемі, відхиляє WordPress до запуску можливості. Це помилка клієнта: вона не несе коду можливості й HTTP-статусу можливості. Перевіряйте вхідні дані за опублікованою схемою до виклику.
Версія контракту
Кожен набір можливостей несе ревізію схеми. Отримати статус файрвола й Отримати можливості повертають contract_version; поточний контракт — ревізія "2". У ревізії 2 змінилися деякі назви: created замінює added, cid замінює event_id, redacted замінює secrets, ban_allowed і would_ban замінюють allowed і would_write, стан перевірки використовує wait_seconds, докази edge — ip_version, а трасування рішення — cid. Якщо ваш клієнт написаний під ревізію 1, оновіть назви полів перед викликом сайту на цій ревізії. Щоб підтвердити розгортання, виконайте Отримати статус файрвола й перевірте, що contract_version дорівнює "2", потім прочитайте Отримати налаштування й перевірте, що output_schema.required містить writable. Якщо після оновлення каталог виглядає старим, очистіть обʼєктний кеш і транзієнти та перезапустіть MCP-клієнт: можливо, MCP-адаптер віддає закешований каталог.
Видимість
Користувачі, які не можуть виконувати можливості BotBlocker, не бачать їх у зібранні можливостей. Вони також не бачать їх у виявленні MCP. За замовчуванням плагін показує PII і руйнівні можливості у виявленні MCP, бо PII_OFF дорівнює true. Щоб сховати їх, задайте PII_OFF як false у wp-config.php до завантаження BotBlocker. Перевірка дозволів лишається межею безпеки: приховування назви ніколи її не замінює.
Можливості аддонів
Деякі аддони оголошують власні можливості. Блок Можливості аддонів на цій вкладці показує кожен установлений аддон, який це робить, з назвами можливостей і поточним станом. Він лише інформаційний: перемикач кожної можливості аддона живе в налаштуваннях цього аддона, і блок веде туди.
- Неактивний аддон лишається у списку з приміткою, що його можливості не зареєстровані, доки він не активний.
- Якщо головний перемикач вимкнений, блок каже про це, і перемикачі аддонів нічого не роблять.
- Якщо жоден установлений аддон не оголошує можливостей, блок не показується взагалі.
Установлені аддони оголошують ці можливості:
- Сканер шкідливого ПЗ:
botblocker/malware-scan-bufferсканує буфер base64 рушієм сигнатур і нічого не записує;botblocker/malware-get-coverageповідомляє області сканування, ліміти, розширення й стан бази сигнатур. Обидві живуть у налаштуваннях аддона. - Заголовки безпеки:
botblocker/get-effective-headersповідомляє набір заголовків і те, як він застосовується до дозволених, заблокованих, перевірених, ненайдених, REST і адмін-відповідей. - Кеш сторінок:
botblocker/get-cache-stateповідомляє, чи можна кешувати URL, стан влучання, ключ, варіант і вимоги до перепустки;botblocker/purge-url-cacheочищає один URL і потребуєPURGE. - Приховування адмінки:
botblocker/get-hidden-routesповідомляє slug входу, URL входу й механізм приховування. - Приховування WordPress:
botblocker/get-wp-hidden-routesповідомляє стан readme, журналу налагодження й htaccess. - Антиспам:
botblocker/classify-commentоцінює коментар, не зберігаючи його. Локальна попередня перевірка працює за замовчуванням;use_classifierнадсилає текст до редакційного сервісу, налаштованого в аддоні. - Form CAPTCHA:
botblocker/get-form-challenge-stateповідомляє TTL, залишок спроб і прив’язки з’єднання для id завдання. - Захист 404:
botblocker/get-404-windowповідомляє лічильник, поріг, вікно, дію й стан блокування для IP. - Захист каналів:
botblocker/get-feed-rulesповідомляє режим фрагментів, атрибуцію, noindex і закриті типи каналів. - Аналіз поведінки:
botblocker/get-behavior-scoreповідомляє оцінку, пороги, сигнали й збережений рівень репутації IP. - Тунель XML-RPC:
botblocker/get-tunnel-stateповідомляє стан тунелю, розмір списку дозволених і чи дозволено IP. - Експорт файрвола:
botblocker/preview-exportбудує текст експорту для одного формату з адресами, замаскованими за замовчуванням. - Early Init:
botblocker/get-early-layer-stateповідомляє стан синхронізації, розгортання роутера, карту сайтів і конфлікти.
Це окремо від конекторів WordPress
Конектори WordPress — це інший перемикач, на BotBlocker → Інтеграції → WordPress Connectors. Він реєструє BotBlocker у системі конекторів WordPress, тож адмін-зона WordPress може показувати BotBlocker як підключений сервіс. Він не публікує жодних можливостей. Можливості не реєструють конектор. Вирішуйте про кожен окремо. Перемикач описано нижче.
Налаштування
Усі налаштування початково вимкнені. Спершу увімкніть головний перемикач, а потім лише потрібні вам можливості.
WP Abilities API
Головний перемикач усієї функції.
Увімкнути можливості BotBlocker
За замовчуванням: Вимкнено
Цей перемикач вмикає або вимикає всю функцію. Коли він вимкнений, жодна можливість BotBlocker не зареєстрована, і перемикачі нижче нічого не роблять. Коли він увімкнений, кожна можливість з увімкненим власним перемикачем стає видимою клієнтам.
- Увімкнено: можливості, які ви вибрали нижче, публікуються.
- Вимкнено: нічого не публікується. Це безпечний вибір, якщо ви не користуєтеся ШІ-асистентом чи інструментом автоматизації.
Якщо клієнт каже, що не може знайти жодної можливості BotBlocker, спершу перевірте цей перемикач.
Лише для читання
Ці можливості лише повідомляють. Вони не можуть змінити ваш сайт.
Отримати статус файрвола
За замовчуванням: Вимкнено
Публікує botblocker/get-firewall-status. Повертає режим захисту, чи ввімкнено захист, і версію плагіна. Це добра перша можливість, щоб перевірити з’єднання, бо вона відповідає лише на одне просте питання.
Перевірити IP-адресу
За замовчуванням: Вимкнено
Публікує botblocker/check-ip. Перевіряє одну IP-адресу за вашими правилами файрвола й повертає правила, що збіглися. Використовуйте, коли хтось каже «Я не можу відкрити ваш сайт», а ви хочете швидку відповідь без входу в Майстерню.
Отримати правила IP
За замовчуванням: Вимкнено
Публікує botblocker/get-ip-rules. Повертає правила файрвола, що збігаються із заданою IP-адресою. З її допомогою клієнт може пояснити, чому BotBlocker ставиться до адреси певним чином. Самими правилами керують у списках IP.
Отримати підсумок трафіку
За замовчуванням: Вимкнено
Публікує botblocker/get-traffic-summary. Повертає підсумки: запити, блокування, captcha, підозрілі візити й проксі-візити. Він дає лічильники, а не окремі рядки журналу, тож не показує подробиць відвідувачів. Ті самі числа є в Майстерні; див. Огляд моніторингу.
Запустити діагностику
За замовчуванням: Вимкнено
Публікує botblocker/run-diagnostics. Запускає перевірки стану теки даних BotBlocker і таблиць бази даних та повідомляє, що знайшов. Він лише дивиться. Він нічого не виправляє. Щоб виправити знайдену проблему, скористайтеся діями з обслуговування.
Керування
Ці можливості змінюють ваш захист. Ставтеся до них так само уважно, як до ручної зміни в Майстерні.
Заблокувати IP-адресу
За замовчуванням: Вимкнено
Публікує botblocker/block-ip. Додає правило блокування файрвола для адреси й знову будує файли блокувань, тож блокування працює одразу.
Це корисно, коли інструмент автоматизації знаходить атакувальника й має швидко його зупинити. Ризик: клієнт із неправильним введенням може заблокувати не ту адресу, зокрема вашу власну. Публікуйте її лише для інструмента, який ви контролюєте. Час від часу перевіряйте свої списки IP на блокування, яких ви не додавали.
Розблокувати IP-адресу
За замовчуванням: Вимкнено
Публікує botblocker/unblock-ip. Видаляє правила файрвола для адреси й знову будує файли блокувань. Це протилежність до Заблокувати IP-адресу.
Ризик: вона може видалити блокування, яке ви хочете зберегти. Якщо ви самі не робили виклику, перевірте, що вона видалила.
Додаткові можливості лише для читання
Список правил IP
За замовчуванням: Вимкнено
Публікує botblocker/list-ip-rules. Перелічує правила, збережені у ваших списках IP: адреса або CIDR, тип правила, пріоритет, термін дії й коментар. Прострочені правила лишаються видимими, якщо клієнт не попросить лише активні правила.
Отримати заблоковані IP-адреси
За замовчуванням: Вимкнено
Публікує botblocker/get-blocked-ips. Повертає лише активні правила блокування. Використовуйте, щоб відповісти на «кого заблоковано прямо зараз?».
Отримати останні події
За замовчуванням: Вимкнено
Публікує botblocker/get-recent-events. Повертає зведену кількість за кожен проміжок часу. Він не показує IP-адрес і user agent, тож його безпечніше ділити з асистентом, ніж необроблений журнал.
Отримати налаштування
За замовчуванням: Вимкнено
Публікує botblocker/get-settings. Повертає несекретні значення вибраної групи, а з all — усі налаштування плагіна. Секрети й персональні дані видно лише як булеве значення в redacted; writable перелічує всі ключі, які приймає Зміна налаштування-перемикача, незалежно від групи.
Отримати стан CAPTCHA
За замовчуванням: Вимкнено
Публікує botblocker/get-captcha-state. Повертає активний режим CAPTCHA, час очікування й список режимів з їхньою доступністю.
Запустити підсумок самоперевірки
За замовчуванням: Вимкнено
Публікує botblocker/run-self-test. Повертає підсумок самоперевірки й причини обходу, не запускаючи справжню самоперевірку.
Перевірити кілька IP-адрес
За замовчуванням: Вимкнено
Публікує botblocker/check-ips. Перевіряє до 20 адрес за один виклик.
Додаткові перемикачі лише для читання
Ці перемикачі публікують розширений набір лише для читання. Усі вимкнені за замовчуванням.
Отримати оцінку здоров’я
За замовчуванням: Вимкнено
Публікує botblocker/get-health-score. Повертає оцінку здоров’я з Панелі керування й кожен пункт, за який нараховано бали.
Знімок захисту
За замовчуванням: Вимкнено
Публікує botblocker/get-protection-snapshot. Повертає стан захисту, безпечний режим, режим CAPTCHA, відповідний набір налаштувань і ознаку авто-довіри edge. Для мінімального стану використовуйте Отримати статус файрвола, для шарів виконання — Стан шарів.
Стан аддонів
За замовчуванням: Вимкнено
Публікує botblocker/get-addons-status. Показує встановлені аддони, активацію, сумісність, можливості й оголошені здібності.
Список каталогу аддонів
За замовчуванням: Вимкнено
Публікує botblocker/list-addon-catalog. Повертає записи каталогу зі slug, версією, потрібним ядром, ознаками встановлення, активності, сумісності й оновлення. Фільтри за текстом, лише встановлені, лише оновлення, limit і offset. Нічого не завантажує й не змінює.
Встановити або оновити аддон
За замовчуванням: Вимкнено
Публікує botblocker/install-addon. Завантажує пакет із каталогу за slug, перевіряє ZIP і маніфест, встановлює або замінює аддон. Потрібна активна ліцензія PRO. Підтвердження: INSTALL.
Увімкнути або вимкнути аддон
За замовчуванням: Вимкнено
Публікує botblocker/set-addon-state. Активує чи деактивує встановлений аддон через життєвий цикл і надсилає bbcs_addon_toggled. Підтвердження: ENABLE або DISABLE.
Видалити встановлений аддон
За замовчуванням: Вимкнено
Публікує botblocker/delete-addon. Вимикає активний аддон, виконує життєвий цикл видалення й прибирає каталог аддона. Підтвердження: DELETE.
Стан ліцензії
За замовчуванням: Вимкнено
Публікує botblocker/get-license-status. Повідомляє стан ліцензії без ключа й секрету.
Отримати можливості
За замовчуванням: Вимкнено
Публікує botblocker/get-capabilities. Зіставляє функції PRO, можливості аддонів і брами захисту.
Перевірити конфігурацію
За замовчуванням: Вимкнено
Публікує botblocker/validate-config. Виконує перевірки лише для читання за налаштуваннями, текою даних, runtime-файлами й таблицями.
Отримати завдання Cron
За замовчуванням: Вимкнено
Публікує botblocker/get-cron-jobs. Аргументи подій приховані, доки фільтр сайту не виставить args_exposed у true.
Здоров’я бази даних
За замовчуванням: Вимкнено
Публікує botblocker/get-db-health. На хостингах, де обмежено information_schema, повертає available=false і причину замість помилки.
Топ сутностей
За замовчуванням: Вимкнено
Публікує botblocker/get-top-entities. Повертає агреговані топ-країни, ASN, групи user-agent, статуси або шляхи.
Підсумок 2FA
За замовчуванням: Вимкнено
Публікує botblocker/get-2fa-summary. Повертає лише лічильники двофакторної автентифікації адміністраторів.
Наступні можливості читають персональні дані: IP-адреси, логіни, user agent або шляхи. Маскування ввімкнене завжди й не вимикається; старий вхідний параметр mask_pii видалено. Маскування обнуляє останній октет адреси, лишає перші символи логіна, e-mail або короткого імені зворотного DNS і скорочує довші імена хостів, user agent і збережений текст результату. Можливості керування правилами повертають збережену адресу без маски, бо це адміністративні інструменти. Адреса peer у Відбитку запиту й ціль бану в Поясненні рішення про бан теж не маскуються; Трасування рішення, Довіра до edge і Докази edge маскують адреси, а псевдонімні id клієнтів у Доказах edge — це хеші, які ніколи не маскуються повторно. За замовчуванням BotBlocker також показує PII і руйнівні можливості в MCP-виявленні, бо PII_OFF дорівнює true у плагіні. Щоб сховати їх з виявлення, задайте PII_OFF як false у wp-config.php до завантаження BotBlocker.
Журнал аудиту
За замовчуванням: Вимкнено
Публікує botblocker/get-audit-log. Це PII: за замовчуванням маскується. За замовчуванням плагін також показує PII і руйнівні можливості в MCP-виявленні, бо PII_OFF дорівнює true. Щоб сховати їх, задайте PII_OFF як false у wp-config.php до завантаження BotBlocker.
Деталі події
За замовчуванням: Вимкнено
Публікує botblocker/get-event-details. Повертає одну подію відвідувача за cid клієнта, з адресою, іменем зворотного DNS, user agent і шляхом. table вибирає hits, suspicious або both (за замовчуванням); збережені поля edge додаються, якщо подія їх несе, а необроблений payload access ніколи не повертається. Це PII, за замовчуванням маскується.
Топ IP-адрес
За замовчуванням: Вимкнено
Публікує botblocker/get-top-ips. Це PII, за замовчуванням маскується.
Спроби входу
За замовчуванням: Вимкнено
Публікує botblocker/get-login-attempts. Це PII, за замовчуванням маскується.
Журнал відвідувачів
За замовчуванням: Вимкнено
Публікує botblocker/get-visitor-log. Це PII, за замовчуванням маскується.
Ризик користувача
За замовчуванням: Вимкнено
Публікує botblocker/get-user-risk. Показує роль, стан двофакторної автентифікації й невдалі входи. Це PII, за замовчуванням маскується.
Виклики здібностей
За замовчуванням: Вимкнено
Публікує botblocker/get-ability-calls. Показує записані виклики здібностей. Це PII, за замовчуванням маскується.
Експорт налаштувань
За замовчуванням: Вимкнено
Публікує botblocker/export-settings. Експортує одну групу налаштувань або всі збережені налаштування; на відміну від Отримати налаштування, за замовчуванням береться група all. Невідома група відхиляється. Секрети замінюються буквальною позначкою [redacted], а redacted_keys їх перелічує. Маскування ввімкнене завжди.
Діагностика
Симуляція запиту
За замовчуванням: Вимкнено
Публікує botblocker/simulate-request. Передбачає рішення за відбитком і нічого не записує.
Трасування рішення
За замовчуванням: Вимкнено
Публікує botblocker/get-decision-trace. Пояснює останнє збережене рішення для IP або id клієнта.
Стан лімітів
За замовчуванням: Вимкнено
Публікує botblocker/get-rate-limit-state. Читає бакети, не додаючи влучання.
Відбиток запиту
За замовчуванням: Вимкнено
Публікує botblocker/get-request-fingerprint. Показує, як BotBlocker нормалізує IP, user agent, TLS-заголовки, geo й протокол.
Цілісність даних
За замовчуванням: Вимкнено
Публікує botblocker/get-data-integrity. Перелічує runtime-файли, відсутні та зайві файли, а також хеші за запитом. Файл авто-довіри входить до списку й вважається відсутнім лише при увімкненій функції.
Збіг сигнатури бота
За замовчуванням: Вимкнено
Публікує botblocker/get-bot-signature-match. Показує, яка сигнатура збіглася з user agent.
Збіг TLS
За замовчуванням: Вимкнено
Публікує botblocker/get-tls-match. Шукає відбиток JA3 або JA4 без рукостискання.
Geo та ASN
За замовчуванням: Вимкнено
Публікує botblocker/get-geo. Читає країну, ASN і організацію з локальної бази ASN.
Стан cache pass
За замовчуванням: Вимкнено
Публікує botblocker/get-pass-state. Перевіряє cookie, зокрема підпис, якщо передано id відвідувача й IP.
Стан перевірки
За замовчуванням: Вимкнено
Публікує botblocker/get-challenge-state. Показує режим CAPTCHA, час очікування, провайдера й залишок спроб.
Збіг правил
За замовчуванням: Вимкнено
Публікує botblocker/get-rule-match. Перелічує всі відповідні правила й переможця.
Стан шарів
За замовчуванням: Вимкнено
Публікує botblocker/get-layer-state. Показує Early Init, MU-плагін, основний щит, шлюзи, стан авто-довіри й конфлікти.
Довіра до edge
За замовчуванням: Вимкнено
Публікує botblocker/get-edge-trust. Показує особистість запиту, авто-довірені записи й карти довіри за флагом, а поле maps_included каже, чи їх прочитано. Адреси завжди маскуються.
Докази edge
За замовчуванням: Вимкнено
Публікує botblocker/get-edge-evidence. Показує накопичені рядки доказів і пороги; адреси й PTR маскуються.
Пояснення рішення про бан
За замовчуванням: Вимкнено
Публікує botblocker/explain-ban-decision. Проганяє гейт банів для цілі й нічого не записує.
Експорт діагностики
За замовчуванням: Вимкнено
Публікує botblocker/export-diagnostics. Збирає налаштування без секретів, цілісність і стан шарів.
Перемикачі для тестів
Тримайте їх вимкненими поза тестовим стендом.
Скидання бакета лімітів
За замовчуванням: Вимкнено
Публікує botblocker/reset-rate-limit. Очищає бакети однієї IP-адреси. Підтвердження: RESET.
Посів тимчасового тестового правила
За замовчуванням: Вимкнено
Публікує botblocker/seed-test-rule. Створює короткоживуче правило з коментарем bbcs-harness:. Підтвердження: SEED.
Очищення тестових правил
За замовчуванням: Вимкнено
Публікує botblocker/clear-test-rules. Видаляє лише правила bbcs-harness:. Підтвердження: CLEAR.
Зміна налаштування-перемикача
За замовчуванням: Вимкнено
Публікує botblocker/set-setting. Вмикає або вимикає одне булеве налаштування захисту тим самим шляхом збереження, що й Майстерня, і відхиляє будь-який ключ поза переліком key. Підтвердження: SET. На окремій сторінці описано дозволені ключі та показано приклади викликів. У списку є bbcs_edge_autotrust, тому авто-довіра знімається одразу.
Завантаження ліцензії з хмари
За замовчуванням: Вимкнено
Публікує botblocker/load-license-from-cloud. Просить сервер ліцензій надіслати ліцензію на сайт і показує стан push. Підтвердження: LOAD. Ключ, nonce і підпис не повертаються.
Додаткові можливості керування
Створити або оновити правило IP
За замовчуванням: Вимкнено
Публікує botblocker/upsert-ip-rule. Створює або оновлює одне правило для IP-адреси чи діапазону CIDR. Відмовляється від рядків лише для читання, а також відмовляється перетворювати правило дозволу на блокування чи блокувати вашу власну адресу без force: true.
Видалити правило IP за id
За замовчуванням: Вимкнено
Публікує botblocker/delete-ip-rule. Видаляє рівно одне правило за його числовим id. Відмовляється від рядків лише для читання.
Додаткові зміни
Ці перемикачі публікують розширений набір змін. Усі вимкнені за замовчуванням. Значення підтвердження вказані біля кожної здібності.
Видалити правила IP для адреси
За замовчуванням: Вимкнено
Публікує botblocker/delete-ip-rules. Видаляє всі не-readonly правила для IP або CIDR, за бажанням одного типу. Підтвердження: DELETE.
Задати правило країни
За замовчуванням: Вимкнено
Публікує botblocker/set-country-rule. Підтвердження: COUNTRY. Відмовляється блокувати країну запиту без force: true.
Задати правило ASN
За замовчуванням: Вимкнено
Публікує botblocker/set-asn-rule. Підтвердження: ASN. Перебудовує runtime-файл ASN і відмовляється блокувати ASN запиту без force: true.
Оновити дані загроз
За замовчуванням: Вимкнено
Публікує botblocker/update-threat-data. Оновлює дані ASN, LLM або TLS. Підтвердження: UPDATE. Спершу використайте dry_run.
Скинути кеш PTR
За замовчуванням: Вимкнено
Публікує botblocker/reset-ptr-cache. Видаляє збережені відповіді зворотного DNS і очищає кеш плагіна. Підтвердження: RESET. Спершу використайте dry_run.
Застосувати набір налаштувань захисту
За замовчуванням: Вимкнено
Публікує botblocker/apply-preset. Підтвердження: PRESET. Повідомляє previous_preset, спершу порівнює поточні налаштування з наборами, потім застосовує один і після цього відновлює кожен перемикач здібностей зі знімка, зробленого перед викликом. Якщо знімок зробити не вдалося, відмовляється до застосування.
Керування захистом (руйнівні)
Ці перемикачі діють із правами адміністратора. Клієнт, який їх має, може вимкнути ваш захист. Публікуйте їх лише для клієнта, який ви контролюєте.
Увімкнути або вимкнути захист
За замовчуванням: Вимкнено
Публікує botblocker/set-protection. Вмикає або вимикає захист через той самий шлях, що й у Майстерні, включно з файлом середовища виконання, який використовується на найраннішому шарі. Виклик потребує ENABLE або DISABLE як підтвердження.
Встановити безпечний режим
За замовчуванням: Вимкнено
Публікує botblocker/set-secure-mode. Перемикається між режимом фронтенду й повним режимом. Повний режим також перевіряє адмін-зону, тож відповідь містить попередження. Виклик потребує FRONTEND або FULL як підтвердження.
Встановити режим CAPTCHA
За замовчуванням: Вимкнено
Публікує botblocker/set-captcha-mode. Перемикає режим CAPTCHA і, необов’язково, час очікування. Режим, недоступний на цьому сайті, відхиляється, а не тихо перемикається на запасний.
Очистити файловий кеш плагіна
За замовчуванням: Вимкнено
Публікує botblocker/clear-cache. Очищає файловий кеш плагіна після ручних змін правил.
Зняти авто-довіру edge
За замовчуванням: Вимкнено
Публікує botblocker/remove-edge-trust. Видаляє один запис авто-довіри за маскою, перепідписує файл і пише edge.trust.removed в аудит. Відповідь повідомляє deleted і remaining. Підтвердження: REMOVE, підтримує dry_run.
Сканер шкідливого ПЗ (PRO)
Ці перемикачі показуються, лише коли аддон Сканер шкідливого ПЗ активний.
Запустити сканування на шкідливе ПЗ
За замовчуванням: Вимкнено
Публікує botblocker/run-malware-scan. Запускає фонове сканування на шкідливе ПЗ. Сканування використовує ресурси сервера, тож публікуйте це, лише якщо справді хочете запускати сканування ззовні Майстерні, наприклад за розкладом зі свого інструмента.
Отримати результати сканування на шкідливе ПЗ
За замовчуванням: Вимкнено
Публікує botblocker/get-scan-results. Повертає статус і знахідки останнього сканування на шкідливе ПЗ. Він лише читає, тож це безпечніша з двох можливостей сканера.
Конектори WordPress
Цей перемикач на BotBlocker → Інтеграції → WordPress Connectors.
Увімкнути BotBlocker у конекторах WordPress
За замовчуванням: Вимкнено
Реєструє BotBlocker у системі конекторів WordPress, тож адмін-зона WordPress може показувати BotBlocker як підключений сервіс.
- Увімкнено: BotBlocker показується в конекторах WordPress.
- Вимкнено: BotBlocker лишається поза конекторами WordPress.
Залиште вимкненим, якщо ви не користуєтеся конекторами WordPress. Він не публікує жодних можливостей.
Коли щось іде не так
- Клієнт не знаходить жодної можливості BotBlocker? Увімкніть Увімкнути можливості BotBlocker. Також перевірте, що ваша версія WordPress має Abilities API.
- Одна можливість відсутня? Увімкніть її власний перемикач. Для можливостей сканера переконайтеся, що аддон «Сканер шкідливого ПЗ» активний.
- Виклик відхилено? Клієнт має входити з обліковим записом адміністратора. Перевірте його облікові дані.
- Захист змінився, і ви не знаєте чому? Перевірте свої списки IP на блокування, яких ви не додавали, і вимкніть перемикачі Керування, доки не з’ясуєте причину. Перевірте журнал аудиту: кожен виклик можливості й кожен відхилений виклик там записано.
- Зміну відхилено з помилкою підтвердження? Клієнт має надіслати відповідне значення
confirm. Це навмисно: так випадковий виклик не змінить захист. - Зміну правила IP відхилено? Правило може бути лише для читання, або зміна заблокувала б вашу власну адресу чи перетворила правило дозволу на блокування. Клієнт має використовувати
force: true, лише коли справді цього хоче.