Документация

Журнал модуля

Журнал включается флажком «Включить логирование» на вкладке «Общие настройки». Настройка общая для всех сайтов установки.

Что попадает в журнал

Записывается путь проверки от начала до решения:

  • отправка пришла без ответа reCAPTCHA — с содержимым запроса, по которому видно, какая форма;
  • ответ Google целиком, включая оценку для v3;
  • отказ по оценке: требуемый порог и полученное значение;
  • отказ Google: проверка не пройдена;
  • недоступность Google: текст ошибки запроса.

Каждая запись несёт адрес страницы, идентификатор сайта, время и место в коде, откуда пришёл вызов.

Что в журнал не попадает

Значения полей с именами, похожими на секреты, заменяются звёздочками ещё до записи: секретный и публичный ключи, пароли, идентификаторы сессий, cookie, платёжные данные, адреса почты и телефоны. Журнал можно передать в поддержку, не вычищая его руками.

Где лежит файл

Файл лежит в каталоге модуля: /bitrix/modules/devbx.recaptcha/. Имя начинается с длинного набора символов, вычисленного из лицензионного ключа установки, и заканчивается на .__recaptcha.log.

Имя сделано неугадываемым намеренно. На штатной настройке сервера каталог модулей и так закрыт снаружи, но настройки бывают нештатными, а журнал — это внутренние данные сайта.

Как читать

bash
tail -n 200 /путь/к/сайту/bitrix/modules/devbx.recaptcha/*.__recaptcha.log

Журнал пишется, пока включён флажок, и растёт со скоростью потока форм. Включайте его на время разбора и выключайте после: на людном сайте файл быстро становится большим.