Перейти до вмісту

Перевірка адона BotBlocker: 3 тести перед заливкою

Адон для BotBlocker Security встановлюється туди, де вже стоїть фаєрвол. Помилка в ньому коштує дорожче, ніж у звичайному плагіні: вона або пропускає те, що мала зупиняти, або блокує платежі й адмінку.

Код: BotBlocker-Add-on-Developer-Kit, ліцензія GPL-3.0.

Тому перевірка адона це три тести, які займають двадцять хвилин і ловлять майже все, що потім коштує ночі.

Тест 1. Валідатор по теці, потім по архіву

validate-addon.php із комплекту перевіряє маніфест, конфлікти імен, відповідність санітайзера та наявність файлів, які маніфест обіцяє.

Запускати треба двічі: спочатку по теці джерел, потім по готовому ZIP. Це різні перевірки. Тека показує помилки коду, архів показує помилки пакування.

Найчастіша знахідка в теці це санітайзер, оголошений у маніфесті, і друга копія логіки, написана в файлі налаштувань пізніше. Обидві працюють, результати різні, і на бойовому сайті зберігається те, що записала друга.

Тест 2. ZIP, який WordPress розпакує

Архів має містити рівно одну кореневу теку з іменем слага. Це не побажання, а вимога інсталятора: він перевіряє структуру до розпакування.

Окремо про Windows. Compress-Archive пише зворотні слеші як роздільники, unzip_file у WordPress їх не нормалізує, і на Linux-хостингу з’являються файли з символом в імені. Інсталяція падає, а повідомлення про помилку не згадує архіви.

Правильні варіанти: package-addon.ps1 із комплекту або zip -r у Linux чи WSL. Після пакування перевірте архів очима: одна тека, всередині маніфест і PHP-файли, без __MACOSX і без .git.

Тест 3. Питання про трафік

Якщо адон не претендує на рішення про трафік, третій тест короткий: переконайтеся, що в маніфесті немає traffic_decision_provider і що весь код виконується після основної перевірки запиту.

Якщо претендує, перевірка стає довшою. Pre-run контракт дозволяє адону впливати на запит раніше за решту плагінів, і погане правило здатне перенаправити живих відвідувачів, зламати колбек оплати, сховати сторінку перевірки або зациклити редиректи.

Мінімум для такого адона: вимкнений стан за замовчуванням, режим пробного прогону без застосування рішень, описаний відкат і вимога ручного підтвердження адміністратора перед бойовими блокуваннями.

Що перевірити в самому коді

Кілька речей, які не ловить жоден валідатор.

Дані про відвідувача беріть з об’єкта ядра, а не з $_SERVER. Ядро нормалізує заголовки проксі й результати перевірок, і пряме читання суперглобала повертає рівно ту проблему підміни, проти якої стоїть фаєрвол.

Налаштування зберігайте одним масивом опцій і читайте через нього ж. Розсипані опції myaddon_option_1..9 потім неможливо ні експортувати, ні прибрати при видаленні плагіна.

Знімайте хуки й очищайте cron у деактивації. Адон, який лишає після себе заплановані події, продовжує писати в базу після видалення.

Перевірте, що адон не ламає сторінку входу. Найпростіший спосіб зробити сайт недоступним для власника це помилка в перевірці, яка спрацьовує й для адміністратора.

Перевірка на стенді

Валідатор не замінює встановлення. Один прогін на копії сайту закриває те, що статичний аналіз не бачить: чи активується адон без помилок, чи з’являється його пункт у меню, чи не ламається сторінка входу після активації.

Послідовність проста. Завантажте ZIP у розділі адонів, активуйте, пройдіть свої сценарії, потім деактивуйте й видаліть. Після видалення перевірте, що опції зникли, а заплановані події більше не виконуються.

Якщо адон пише у власну таблицю, видалення має прибирати і її. Плагін, який лишає по собі таблицю на десять тисяч рядків, помітний не одразу, а через рік.

Куди дивитися далі

Контракт рантайму в комплекті пояснює порядок завантаження і відповідає на більшість питань «чому адон не працює». Довідник API v2 описує маніфест і поля налаштувань.

Комплект відкритий: BotBlocker Add-on Developer Kit, GPL-3.0. Документація продукту є на botblocker.top/docs, а можливості ядра описані на сторінці можливостей.

Про сам продукт і його межі: документація BotBlocker. Про безпеку плагінів у загальному вигляді: Plugin Handbook.