Перемикання налаштувань із клієнта
botblocker/set-setting вмикає або вимикає одне булеве налаштування захисту. Можливість іде тим самим шляхом збереження, що й Майстерня, тому рядок налаштувань, згенерований runtime-файл і працюючий плагін отримують одне й те саме значення.
Вона потрібна, коли клієнт має пройти режимами захисту без людини, яка клацає перемикачі. Основний випадок — стенд, що перевіряє плагін та його аддони в різних комбінаціях.
Щоб опублікувати можливість, відкрийте BotBlocker → Інтеграції → WP Abilities API, увімкніть головний перемикач, потім увімкніть Зміна налаштування-перемикача. Обидва перемикачі вимкнені за замовчуванням.
Що змінює виклик
Можливість записує рядок налаштування в таблицю налаштувань BotBlocker, перезбирає settings.php у теці даних і оновлює обʼєкт налаштувань, який уже тримає поточний запит. Ранній захист читає settings.php до завантаження WordPress, тому без перезбирання перший шар залишився б на старому значенні.
Кілька налаштувань мають додаткову роботу, і можливість виконує її так само, як Майстерня:
early_init_enableіmu_enableзалишаються взаємовиключними. Увімкнення одного вимикає інше, а файл MU-завантажувача встановлюється або видаляється відповідно.block_rknпід час увімкнення планує оновлення списків загроз.redis_enable,memcached_enableіapcu_enableспершу перевіряють бекенд. Якщо перевірка не пройшла, перемикач лишається вимкненим, а виклик повертає помилку замість збереження мертвої інтеграції.
Підтвердження, пробні виклики та ліміти
Кожному виклику потрібен confirm зі значенням SET. Без нього можливість відмовляє й нічого не пише.
dry_run: true повідомляє значення, яке було б записане, і що змінилося б, після чого зупиняється. Використовуйте його перед серією справжніх викликів.
Можливість обмежена за частотою, як інші руйнівні можливості. Кожен виклик від користувача, який увійшов, потрапляє до журналу аудиту з імʼям налаштування, старим і новим значенням.
Поля відповіді
| Поле | Значення |
|---|---|
key |
Налаштування, яке запросили. |
previous |
Значення до виклику. |
enabled |
Чинне значення після виклику. |
changed |
Чи відрізняється значення від попереднього. |
applied |
Чи записав цей виклик рядок. Пробний виклик і відхилене PRO-налаштування лишають false. |
reason |
Порожньо за успіху, license коли PRO-налаштування не покрите активною ліцензією. |
protection_enabled |
Чи ввімкнений сам захист BotBlocker. |
Які налаштування можна змінювати
Приймаються лише ключі з цього списку. Усе інше відхиляється з ability_invalid_input.
Захист і перевірки запиту:
check— головна перевірка ботів.botblocker_force_checkперевіряє кожне завантаження сторінки, включно з користувачами, які увійшли, і білим списком.skip_logged_in_usersпоширює обхід на всі ролі, які увійшли.allow_self_ip_reqдозволяє серверу звертатися до себе.allow_self_call_headerпідписує вихідні самовиклики.allow_app_password_restпропускає валідні application password повз захист.autosave_admin_ipзберігає адреси адміністраторів у довірений список.options_preflightпропускає CORS preflight.iframe_stopблокує показ сайту у фреймі.check_get_refперевіряє GET-параметри в referer.bbcs_ddos_resilienceзміцнює цикл перевірки за WAF або CDN.
Виявлення ботів:
block_simplebot_ua,block_empty_ua,block_empty_lang,block_http10_usersblock_fake_ref,block_incorrect_lang_users,block_ip_ptr_matchblock_cf_users,block_proxy_users,block_ipv6_usersblock_adblocker_users,block_incognito_users,block_simple_antidetectfingerprint_sticky_block,whitelist_whatsapp_previewget_browser_type,get_device_type,get_os_typebbcs_allow_empty_accept_langbbcs_edge_autotrust(вимкнення одразу знімає всю авто-довіру)
CAPTCHA:
bbcs_honeypot_enabledrecaptcha_checkbbcs_captcha_img_inlinerecaptcha_v3_ipv6_block
Cookie та заголовки:
session_token_enabled,vary_cookienoarchive,utm_noindex,utm_referrerbbcs_cors_strict_headers
Хмара та кеш:
force_cloud_validation,cloud_fallback_blocktransients_enable,cache_ui_dataredis_enable,memcached_enable,apcu_enable
Логування:
botblocker_log_error,botblocker_log_admin,botblocker_log_allowbotblocker_log_bbcs,botblocker_log_block,botblocker_log_clibotblocker_log_disabled,botblocker_log_fake,botblocker_log_goodipbotblocker_log_local,botblocker_log_tests,botblocker_log_wpaudit_log_enable
Облікові записи, оплата та шари:
login_brutforce_enabledpayment_bypass_enable,payment_bypass_logpayment_strict_method,payment_keep_ip_rulesbbcs_2fa_enable,bbcs_2fa_xmlrpc_blockmu_enable,mu_geo_enableearly_init_enable,early_geo_enable,early_cache_gate
Обмеження частоти, TLS і зворотний DNS:
bbcs_rate_check_enabled,bbcs_rate_subnet_enabledtls_fingerprint_checkptr_cache_in_db
PRO-налаштування теж у списку: hosting_block, block_device_options, block_web_engine_options, block_override, block_vpn_users, block_tor_users, block_rkn. Без відповідної ліцензії виклик їх не вмикає. Відповідь буде applied: false і reason: license, як і під час збереження в Майстерні, коли PRO-значення лишається без ліцензії.
Які налаштування відхиляються
Частина налаштувань має власну можливість, а частину клієнт не має записувати ніколи:
disableналежитьbotblocker/set-protection.secure_modeналежитьbotblocker/set-secure-mode.bbcs_captcha_modeіbbcs_captcha_waitналежатьbotblocker/set-captcha-mode.- Секрети не чіпаємо:
salt,secret_botblocker_get_param,action_disable,action_off,action_on, ключі та паролі Cloud, ключі reCAPTCHA і паролі кешу. - Усі перемикачі
bbcs_ability_*іbbcs_wp_abilities_enabledлишаються поза списком. Клієнт не повинен уміти публікувати або приховувати власні можливості. - Числа й рядки, що визначають поведінку сайту, не є перемикачами:
hits_per_user,time_ban,header_error_code,cookie,samesite, таймаути та пороги.
Приклади
Вимкнути головну перевірку ботів перед базовим прогоном:
wp eval '
$result = wp_get_ability( "botblocker/set-setting" )->execute( array(
"key" => "check",
"enabled" => false,
"confirm" => "SET",
"reason" => "baseline run",
) );
print_r( $result );
'Відповідь покаже previous: true, enabled: false і applied: true. У таблиці налаштувань тепер check = 0, і в settings.php теж.
Подивитися, що дасть зміна, без запису:
wp eval '
$result = wp_get_ability( "botblocker/set-setting" )->execute( array(
"key" => "bbcs_honeypot_enabled",
"enabled" => true,
"confirm" => "SET",
"dry_run" => true,
) );
print_r( $result );
'Тут changed дорівнює true, якщо значення відрізняється, а applied лишається false.
Той самий виклик через REST, під адміністратором:
curl -X POST "https://example.com/wp-json/wp-abilities/v1/abilities/botblocker/set-setting/run" \
-u "admin:application-password" \
-H "Content-Type: application/json" \
-d '{"key":"early_cache_gate","enabled":1,"confirm":"SET"}'Для запиту підійде application password адміністратора. Самій можливості все одно потрібне право manage_options.
Увімкнути режим MU, коли ввімкнений Early Init:
wp eval '
$result = wp_get_ability( "botblocker/set-setting" )->execute( array(
"key" => "mu_enable",
"enabled" => true,
"confirm" => "SET",
) );
print_r( $result );
'Відповідь буде applied: true, а early_init_enable після цього читається як 0. MU-завантажувач на місці, бо Майстерня зробила б те саме.
Помилки
| Код | Коли |
|---|---|
ability_confirmation_required |
confirm був відсутній або не дорівнює SET. |
ability_invalid_input |
Ключа немає в списку дозволених або enabled не переданий. |
ability_backend_unavailable |
Бекенд кешу не відповів на перевірку. Перемикач лишається вимкненим. |
ability_rate_limited |
Забагато руйнівних викликів за короткий час. |
ability_execution_failed |
Рядок налаштувань записати не вдалося. |
rest_forbidden |
Викликач не адміністратор. |
Якщо зміна не дала ефекту
Спершу ввімкніть перемикач можливості, потім головний перемикач. Якщо головний вимкнений, нічого не зареєстровано, і виклик до плагіна не доходить.
Для Early Init і режиму MU перевірте botblocker/get-layer-state. Вона повідомляє, який шар відповідає і чи розгорнуті роутер або MU-завантажувач.
Якщо бекенд кешу не вмикається, причина в перевірці зʼєднання. Виправте хост або порт у налаштуваннях кешу й повторіть.
Зміна налаштування-перемикача
За замовчуванням: Вимкнено
Цей перемикач публікує botblocker/set-setting. Вмикайте його лише для клієнта, який ви контролюєте, і лише поки стенду це потрібно. Клієнт із цією можливістю може змінювати налаштування захисту в межах списку вище, і діє він із правами адміністратора.
- Увімкнено: можливість реєструється, коли ввімкнений головний перемикач.
- Вимкнено: можливості не існує для REST, MCP і ШІ-клієнтів.
Повʼязані сторінки: Можливості та конектори WordPress.