reCAPTCHA
Використовуйте Google reCAPTCHA як перевірку відвідувачів або як невидимий додатковий бал поверх будь-якої перевірки.
Багато відвідувачів знають прапорець Google «Я не робот». Якщо ви хочете таку звичну перевірку на своєму сайті, BotBlocker може її використати. BotBlocker підтримує дві версії reCAPTCHA, і вони виконують різні завдання:
- reCAPTCHA v2 — видима перевірка. Відвідувач ставить прапорець, а іноді розв’язує завдання із зображеннями. Ви вибираєте її як Режим Captcha.
- reCAPTCHA v3 — невидима. Google дає кожному відвідувачу бал від 0.0 (бот) до 1.0 (людина), і BotBlocker відхиляє відвідувачів із низьким балом. Вона працює разом з будь-яким режимом Captcha.
reCAPTCHA це сервіс Google. Браузер відвідувача завантажує її із серверів Google, а ваш сервер надсилає кожну відповідь Google для перевірки. Див. Зовнішні сервіси та приватність.

Панель reCaptcha v2. Відкрийте її через BotBlocker → Інтеграції → reCaptcha v2.
Отримайте ключі від Google
Кожній версії потрібна власна пара ключів: ключ сайту (публічний) і секретний ключ (приватний). Ви створюєте їх безкоштовно в консолі адміністратора Google reCAPTCHA. Поки ключа немає, панелі показують посилання Створити зараз.
Коли ви створюєте ключі:
- Виберіть правильний тип: «Challenge (v2)» із прапорцем «Я не робот» для v2 або «Score based (v3)» для v3. Ключі однієї версії не працюють для іншої.
- Додайте кожен домен, яким користуються відвідувачі, наприклад і
example.com, іwww.example.com. Додайте також тестовий домен або створіть для нього окремі ключі. - Скопіюйте обидва ключі у відповідну панель BotBlocker і збережіть.
Використовуйте v2 як видиму перевірку
Найшвидший спосіб: відкрийте BotBlocker → Інтеграції → reCaptcha v2, вставте обидва ключі й натисніть Використати reCAPTCHA v2 у розділі Сторінка перевірки. Це зберігає ключі й одним кроком перемикає сторінку перевірки на reCaptcha v2. Розділ показує, яку перевірку відвідувачі бачать зараз.
Після збереження обох ключів v2 на BotBlocker → Налаштування → Контроль доступу → Captcha (Режими перевірки) стають доступні два режими:
- reCaptcha v2 — «Я не робот»: відвідувач ставить прапорець, а потім натискає кнопку, щоб продовжити.
- reCaptcha v2: відвідувач ставить прапорець, і сторінка продовжує сама.
Без обох ключів ці два режими сірі. Якщо ви пізніше приберете ключі, BotBlocker під час збереження налаштувань перемкне режим назад на Кнопка — «Я не робот».
Якщо Google каже, що відповідь неправильна, відвідувач не проходить перевірку. BotBlocker блокує IP-адресу відвідувача на Час блокування із Блокувань і відповідей.
Якщо Google не може перевірити відповідь, BotBlocker не блокує відвідувача. Він натомість показує перевірку Кнопка — «Я не робот», і відвідувач натискає кнопку, щоб продовжити. Так буває, коли ваш сервер не може дістатися Google, Google повертає помилку сервера або ваш Секретний ключ reCaptcha v2 неправильний. Якщо ввімкнено Записувати запити на ручну перевірку, запис у журналі для цього візиту показує CAPTCHA provider error і причину. Неправильний секретний ключ відправляє кожного відвідувача на перевірку кнопкою, тож перевірте її після збереження нових ключів.
Використовуйте v3 як невидимий додатковий бал
Щоб увімкнути, відкрийте BotBlocker → Інтеграції → reCaptcha v3, вставте обидва ключі й натисніть Увімкнути reCAPTCHA v3 у розділі Фонова перевірка. Це зберігає ключі й одним кроком вмикає Увімкнути захист reCaptcha v3. Ваша сторінка перевірки лишається як була.
reCAPTCHA v3 працює під час звичайної перевірки браузера в BotBlocker, до показу будь-якого завдання. Google повертає бал, і BotBlocker порівнює його з порогом у налаштуванні Рівень порогу reCaptcha:
- Бал вищий за поріг: відвідувач проходить звичайні перевірки.
- Бал на порозі або нижчий: BotBlocker відхиляє відвідувача.
- Немає відповіді від Google: BotBlocker рахує бал як 0, тож відвідувача відхилено.
- Немає балу в браузері відвідувача: якщо скрипт Google не дає бал протягом 5 секунд, наприклад через неправильний ключ сайту, сторінка перевірки продовжує без балу v3. Відвідувач отримує лише ваші інші перевірки.
Відвідувач нічого не бачить. Це добре для досвіду користувача, але відхилена людина теж не може сказати чому. Почніть із порогу за замовчуванням і стежте за звітами.

Панель reCaptcha v3. Відкрийте її через BotBlocker → Інтеграції → reCaptcha v3.
Країни, де Google заблоковано. BotBlocker не використовує v3 для відвідувачів із фіксованого списку країн, де сервіси Google часто недоступні або обмежені (наприклад, Китай, Іран і Росія). Ці відвідувачі отримують лише ваші звичайні перевірки.
Налаштування
reCaptcha v2
Ключі для видимої перевірки прапорцем.
Ключ сайту reCaptcha v2:
За замовчуванням: порожньо
Публічний ключ. Браузер відвідувача надсилає його Google, щоб показати прапорець. Це має бути ключ v2, створений для домену, яким користуються відвідувачі. Ключ для іншого домену показує помилку в прапорці.
Секретний ключ reCaptcha v2:
За замовчуванням: порожньо
Приватний ключ. Ваш сервер використовує його, щоб запитати Google, чи відповідь відвідувача дійсна. Не діліться ним і не показуйте його на скриншотах. Якщо він витече, створіть нові ключі в консолі Google.
reCaptcha v3
Невидима перевірка балом. Обидва перемикачі залишаються сірими, доки не збережено обидва ключі v3.
Увімкнути захист reCaptcha v3
За замовчуванням: Вимкнено
Вмикає або вимикає перевірку балом v3.
- Увімкнено: кожен відвідувач, який проходить перевірку браузера в BotBlocker, отримує бал Google. Низькі бали відхиляються.
- Вимкнено: балу v3 немає. Ваші ключі v3 зберігаються, але не використовуються.
Спершу збережіть обидва ключі v3, потім увімкніть це.
Вимкнути reCaptcha для відвідувачів IPv6
За замовчуванням: Вимкнено
Пропускає бал v3 для відвідувачів, які з’єднуються через IPv6.
- Увімкнено: відвідувачі IPv6 не отримують бал v3. Якщо ваш режим Captcha — один із режимів reCaptcha v2, відвідувачі IPv6 натомість отримують завдання Кнопка — «Я не робот», а не прапорець Google. Усі ваші інші перевірки далі діють.
- Вимкнено: відвідувачів IPv6 оцінюють як усіх.
Панель каже, що Google не підтримує оцінювання IPv6. Якщо ви бачите, що справжніх відвідувачів IPv6 відхиляють, увімкніть це.
Ключ сайту reCaptcha v3:
За замовчуванням: порожньо
Публічний ключ для балу v3. Це має бути ключ v3, створений для домену, яким користуються відвідувачі. Використовуйте окремі ключі для тестового й живого сайту.
Секретний ключ reCaptcha v3:
За замовчуванням: порожньо
Приватний ключ. Ваш сервер використовує його, щоб отримати бал від Google. Тримайте його приватним, як і секретний ключ v2.
Рівень порогу reCaptcha
За замовчуванням: 0.5
Найнижчий бал, який ще достатній. Повзунок іде від 0.1 до 1.0 кроками по 0.1. Відвідувача з балом на цьому значенні або нижче відхиляють.
- Нижче число: толерантніше. Менше справжніх людей відхиляють, але більше ботів проходить.
- Вище число: суворіше. Більше ботів зупинено, але й більше справжніх людей відхилено.
Змінюйте його малими кроками (по 0.1) і перевіряйте звіти після кожної зміни. У магазині або на сайті з формами занадто суворе значення відганяє справжніх клієнтів без жодного повідомлення.
Коли щось іде не так
- Прапорець показує «Invalid domain for site key»? Ключ створено для іншого домену. Додайте свій домен (з
wwwі без) у консолі Google. - Відвідувачі ставлять прапорець, а потім бачать перевірку кнопкою? Google не зміг перевірити відповідь. Ваш Секретний ключ reCaptcha v2 неправильний, або ваш сервер не може дістатися
www.google.com. Запис у журналі показує причину. Скопіюйте обидва ключі з консолі Google ще раз. - Режими reCaptcha v2 сірі? Спершу збережіть обидва ключі v2 на BotBlocker → Інтеграції → reCaptcha v2.
- Перемикачі v3 сірі? Спершу збережіть обидва ключі v3.
- Сторінка перевірки чекає близько 5 секунд, перш ніж продовжити? Браузер не отримав балу v3 від Google, тож v3 не захищає ваш сайт. Перевірте, що Ключ сайту reCaptcha v3 це ключ v3, створений для вашого домену.
- Справжніх відвідувачів відхиляють після ввімкнення v3? Знизьте Рівень порогу reCaptcha або перевірте, чи ваш сервер може дістатися
www.google.com. Якщо Google не відповідає, кожен відвідувач отримує бал 0. - Працює на тестовому сайті, але не на живому? Ключі зареєстровано для неправильного домену. Використовуйте ключі, які містять живий домен.
- Сайт має працювати просто зараз? Вимкніть Увімкнути захист reCaptcha v3 і виберіть Режим Captcha з локальних режимів у Режимах перевірки. Ваші ключі залишаться збереженими.
Пов’язані сторінки
- Режими перевірки
- Огляд перевірки
- hCaptcha і Turnstile, інші зовнішні перевірки