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. Добавьте также свой staging-домен или создайте для него отдельные ключи. - Скопируйте оба ключа в соответствующую панель в 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, созданный для домена, который используют посетители. Используйте отдельные ключи для staging и для боевого сайта.
Секретный ключ 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. - Работает на staging, но не на боевом сайте? Ключи зарегистрированы для неверного домена. Используйте ключи, которые включают боевой домен.
- Нужно, чтобы сайт работал прямо сейчас? Выключите Включить защиту reCaptcha v3 и установите Режим Captcha на локальный режим в разделе Режимы проверки. Ваши ключи остаются сохранёнными.
Связанные страницы
- Режимы проверки
- Обзор проверки
- hCaptcha и Turnstile, другие внешние проверки