Ключи и версия проверки

Настройки модуля открываются в админке: Настройки → Настройки продукта → Настройки модулей → DEV-BX Google ReCaptcha.

Вкладок четыре:

Вкладка	Что задаёт
Настройки сайтов	ключи, версию, порог, внешний вид и правила показа — отдельно для каждого сайта
Общие настройки	стили, журнал и отладку — сразу для всего модуля
Доступ	какие группы пользователей видят и меняют настройки
Тех. поддержка	форма обращения в поддержку модуля

Настройки первой вкладки хранятся с привязкой к сайту. На установке с двумя сайтами у каждого свои ключи, своя версия и свои правила показа — переключение между сайтами идёт вкладками внутри самой формы.

Активность

Пока флажок «Активность» снят, модуль не делает ничего: страницы отдаются со штатной капчой Битрикса. Это же и способ быстро вернуться к штатной капче, не удаляя модуль.

Ключи

Ключи выдаёт Google в консоли reCAPTCHA — https://www.google.com/recaptcha/admin. Пара всегда из двух частей:

• Публичный ключ уходит в страницу и виден всем — им браузер посетителя запрашивает проверку;
• Секретный ключ остаётся на сервере — им модуль подтверждает ответ у Google.

Секретный ключ никуда, кроме запроса к Google, не отправляется и в журнал модуля не пишется: значения полей с именами вроде secret и private маскируются перед записью.

Ключи выдаются под конкретную версию reCAPTCHA. Ключ от v2 не подойдёт к v3 и наоборот — проверка будет отвечать отказом на каждую отправку формы.

Версия проверки

Значение поля	Что видит посетитель
reCAPTCHA v3	ничего: оценка считается по поведению, форма отправляется как обычная
reCAPTCHA v2 — Невидимый значок	ничего, пока Google не сочтёт поведение подозрительным; тогда появляется задание
reCAPTCHA v2 — Флажок «Я не робот»	флажок в форме, иногда задание с картинками

Версия меняет и набор полей в форме настроек: часть из них к остальным версиям отношения не имеет и прячется. Для флажка остаются только активность, ключи и цветовая схема.

Поля по версиям:

Поле	v3	v2 невидимый значок	v2 флажок
Контекст	есть	нет	нет
Порог прохождения	есть	нет	нет
Расположение бейджа	есть	есть	нет
Цветовая схема	есть	есть	есть

Требование к PHP

Модуль работает на PHP 8.0 и выше. На более старой версии он молча не включается: проверка стоит в самом начале include.php, до регистрации обработчиков. Страницы при этом остаются со штатной капчой Битрикса, ошибок в журнале сервера не появляется.