Перемикання налаштувань із клієнта

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_users
  • block_fake_ref, block_incorrect_lang_users, block_ip_ptr_match
  • block_cf_users, block_proxy_users, block_ipv6_users
  • block_adblocker_users, block_incognito_users, block_simple_antidetect
  • fingerprint_sticky_block, whitelist_whatsapp_preview
  • get_browser_type, get_device_type, get_os_type
  • bbcs_allow_empty_accept_lang
  • bbcs_edge_autotrust (вимкнення одразу знімає всю авто-довіру)

CAPTCHA:

  • bbcs_honeypot_enabled
  • recaptcha_check
  • bbcs_captcha_img_inline
  • recaptcha_v3_ipv6_block

Cookie та заголовки:

  • session_token_enabled, vary_cookie
  • noarchive, utm_noindex, utm_referrer
  • bbcs_cors_strict_headers

Хмара та кеш:

  • force_cloud_validation, cloud_fallback_block
  • transients_enable, cache_ui_data
  • redis_enable, memcached_enable, apcu_enable

Логування:

  • botblocker_log_error, botblocker_log_admin, botblocker_log_allow
  • botblocker_log_bbcs, botblocker_log_block, botblocker_log_cli
  • botblocker_log_disabled, botblocker_log_fake, botblocker_log_goodip
  • botblocker_log_local, botblocker_log_tests, botblocker_log_wp
  • audit_log_enable

Облікові записи, оплата та шари:

  • login_brutforce_enabled
  • payment_bypass_enable, payment_bypass_log
  • payment_strict_method, payment_keep_ip_rules
  • bbcs_2fa_enable, bbcs_2fa_xmlrpc_block
  • mu_enable, mu_geo_enable
  • early_init_enable, early_geo_enable, early_cache_gate

Обмеження частоти, TLS і зворотний DNS:

  • bbcs_rate_check_enabled, bbcs_rate_subnet_enabled
  • tls_fingerprint_check
  • ptr_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.