Возможности и подключения WordPress

Позвольте ИИ-ассистентам и другим инструментам задавать BotBlocker вопросы или даже блокировать адрес — ровно с тем доступом, который вы выберете.

В новых версиях WordPress есть API возможностей. С его помощью плагин может публиковать именованные действия, называемые возможностями. Другое программное обеспечение может находить эти действия и вызывать их: REST-клиенты, инструменты автоматизации и ИИ-ассистенты через MCP. Поэтому вы можете спросить у ассистента «заблокирован ли этот IP?» и получить ответ от BotBlocker, не открывая Панель управления.

Это удобно, но этим вы открываете дверь. Возможность чтения безвредна. Возможность, которая блокирует адрес, меняет вашу защиту. Поэтому каждая возможность BotBlocker по умолчанию выключена. Главный переключатель управляет всей функцией, и у каждой возможности есть свой переключатель. Вы публикуете только те действия, которым доверяете, и ничего больше.

Настройки WP Abilities API BotBlocker

Панель API возможностей WP. Откройте её через BotBlocker → Интеграции → API возможностей WP.

Когда это выключено, возможностей не существует

Когда главный переключатель выключен, BotBlocker ничего не регистрирует. Его возможности не показываются ни в списке возможностей, ни в REST, ни в MCP, ни в конечных точках запуска. Клиент не может вызвать то, чего не существует. Это безопасное состояние, и оно является значением по умолчанию.

Когда вы включаете главный переключатель, видимыми становятся только те возможности, у которых включён собственный переключатель. Если в вашей версии WordPress нет API возможностей, BotBlocker ничего не регистрирует, даже со всеми включёнными переключателями.

Переключение целой группы сразу

Переключателей много, поэтому над списком в левой колонке есть три кнопки. Они меняют переключатели на странице; ничего не сохраняется, пока вы не нажмёте Сохранить. Наведите на кнопку, чтобы увидеть, что она делает.

  • Включить все включает главный переключатель и каждую возможность BotBlocker. Возможности аддонов не затрагиваются, потому что их переключатели находятся в настройках аддона.
  • Только чтение включает главный переключатель, выключает все возможности и затем включает группу только для чтения. Это обычная отправная точка: клиент может задавать вопросы и не может изменить защиту.
  • Выключить все выключает главный переключатель и все возможности. Клиенты больше ничего не видят от BotBlocker.

Вызывать их могут только администраторы

Каждой возможности BotBlocker требуется право manage_options, поэтому вызвать её может только учётная запись администратора. Клиент (ассистент или инструмент) действует с той учётной записью, под которой он входит. Поэтому относитесь к клиенту, который может вызывать эти возможности, как к человеку с вашим паролем администратора. Дайте ему учётную запись и учётные данные, которые вы контролируете.

Начните с чтения, изменяющие добавьте позже

Возможности объединены в группы:

  • Возможности Только для чтения лишь дают информацию. Они не могут ничего изменить. Начните с них.
  • Возможности Управления добавляют, изменяют или удаляют правила IP, обслуживающие данные и установленные аддоны. Включайте их только когда у вас есть ясная задача для них.
  • Возможности Управления защитой (разрушительные) меняют настройки защиты: включение и выключение защиты, режим защиты, режим CAPTCHA и очистку кэша. Они действуют как администратор в Панели управления.
  • Возможности Сканера вредоносных программ (PRO) запускают сканирование или читают его результаты. Вы видите их только когда активен аддон Сканер вредоносных программ.

Новые возможности чтения

  • Список правил 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, время ожидания и доступность каждого режима на этом сайте.
  • Сводка самотеста — botblocker/run-self-test. Возвращает сводку самотеста и причины обхода без запуска нового теста и без записи в журнал.
  • Проверка нескольких IP — botblocker/check-ips. Проверяет до 20 адресов за один вызов.

botblocker/check-ip проверяет сохранённые IP-правила и hot-ban с тем же приоритетом, что и боевой движок: игнорирует истёкшие правила и служебные строки локальных и серверных адресов, сообщает активный hot-ban. В ответе есть 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. На отдельной странице описаны ключи и показаны примеры вызовов.

Возможности аддонов

Активные аддоны объявляют свои возможности, а их переключатели лежат в настройках аддона.

  • Сканер вредоносных программ: 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.
  • Удалить правило по id — botblocker/delete-ip-rule. Удаляет ровно одно правило по номеру. Номера уникальны только внутри одного семейства адресов, поэтому передайте family (ipv4 или ipv6), если такой номер есть в обоих; иначе вызов отклоняется с ability_ambiguous_rule_id.

Обе возможности отказываются менять и удалять readonly-правила (адрес администратора и сервера). Они также отказываются превращать allow в block или блокировать текущий 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. Меняет защиту тем же путём, что и тумблер в Панели, включая runtime-файл самого раннего слоя. Подтверждение: ENABLE или DISABLE.
  • Режим защиты — botblocker/set-secure-mode. Переключает frontend и full. Полный режим проверяет и админку WordPress. Подтверждение: FRONTEND или FULL.
  • Режим CAPTCHA — botblocker/set-captcha-mode. Меняет режим и, при необходимости, время ожидания. Недоступный на сайте режим отклоняется с ошибкой, а не тихо подменяется.
  • Очистить файловый кэш — 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. Он регистрирует BotBlocker в системе подключений WordPress, поэтому админ-зона WordPress может перечислить BotBlocker как подключённый сервис. Он не публикует никаких возможностей. Возможности не регистрируют подключение. Решайте по каждому отдельно. Переключатель описан ниже.

Настройки

Все настройки по умолчанию выключены. Сначала включите главный переключатель, а затем только те возможности, которые вам нужны.

API возможностей WP

Главный переключатель для всей функции.

Включить возможности 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. Отказывается менять readonly-строки и превращать allow в block без force: true.

Удалить правило по id

По умолчанию: Выключено

Публикует botblocker/delete-ip-rule. Удаляет ровно одно правило по номеру и отказывается удалять readonly-строки.

Дополнительные изменения

Эти переключатели публикуют расширенный набор изменений. Все выключены по умолчанию. Значения подтверждения указаны у каждой способности.

Удалить правила 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. Меняет защиту тем же путём, что и Панель, включая runtime-файл. Требует ENABLE или DISABLE.

Режим защиты

По умолчанию: Выключено

Публикует botblocker/set-secure-mode. Переключает frontend и full. Полный режим проверяет и админку, поэтому ответ содержит предупреждение. Требует FRONTEND или FULL.

Режим CAPTCHA

По умолчанию: Выключено

Публикует botblocker/set-captcha-mode. Меняет режим и время ожидания. Недоступный режим отклоняется с ошибкой.

Очистить файловый кэш

По умолчанию: Выключено

Публикует 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.

Включить BotBlocker в подключениях WordPress

По умолчанию: Выкл.

Регистрирует BotBlocker в системе подключений WordPress, поэтому админ-зона WordPress может перечислить BotBlocker как подключённый сервис.

  • Вкл.: BotBlocker появляется в подключениях WordPress.
  • Выкл.: BotBlocker остаётся вне подключений WordPress.

Оставьте его выключенным, если вы не пользуетесь подключениями WordPress. Он не публикует никаких возможностей.

Когда что-то идёт не так

  • Клиент не находит ни одной возможности BotBlocker? Включите Включить возможности BotBlocker. Также проверьте, что в вашей версии WordPress есть API возможностей.
  • Одной возможности не хватает? Включите её собственный переключатель. Для возможностей сканера убедитесь, что активен аддон «Сканер вредоносных программ».
  • Вызов отклонён? Клиент должен войти с учётной записью администратора. Проверьте его учётные данные.
  • Защита изменилась, а вы не знаете почему? Проверьте свои Списки IP и прокси на блокировки, которые вы не добавляли, и выключите переключатели Управление, пока не узнаете причину.