Установка Яндекс SmartCaptcha PRO, ver. 1.0.0

Модуль заменяет стандартную CAPTCHA платформы «1С-Битрикс» (и Корпоративный портал 1С-Битрикс24: Интернет-магазин + CRM) на Yandex SmartCaptcha и помогает защитить формы сайта от автоматических отправок, спама и действий ботов.

После установки модуль автоматически находит формы, в которых используется стандартная CAPTCHA Битрикс, скрывает изображение с кодом и поле ручного ввода, после чего размещает на их месте виджет Yandex SmartCaptcha. Изменение шаблонов стандартных компонентов в большинстве случаев не требуется.

Проверка пользователя выполняется как на стороне браузера, так и на сервере. Полученный от Yandex SmartCaptcha токен передается на сервер Yandex для валидации. Только после успешной проверки модуль разрешает стандартному механизму Битрикс продолжить обработку формы.

• автоматическая замена стандартной CAPTCHA Битрикс;

• видимый и невидимый режимы Yandex SmartCaptcha;

• серверная проверка токена SmartCaptcha;

• поддержка нескольких форм с CAPTCHA на одной странице;

• поддержка форм, загружаемых через AJAX;

• обработка динамически добавляемых форм;

• поддержка стандартных и вложенных полей CAPTCHA;

• отдельные настройки для каждого сайта в многосайтовой конфигурации;

• выбор языка виджета;

• настройка положения служебного элемента SmartCaptcha;

• исключение отдельных страниц по URL-маскам;

• настройка собственного сообщения об ошибке;

• настройка таймаута загрузки клиентского скрипта;

• настройка таймаута серверной проверки;

• выбор поведения при временной недоступности серверов Yandex;

• автоматический возврат к стандартной CAPTCHA Битрикс при ошибке загрузки виджета;

• журналирование результатов и ошибок проверки;

• встроенная диагностика настроек.

Видимый режим

В форме отображается стандартный виджет Yandex SmartCaptcha. Пользователь проходит проверку перед отправкой формы.

Невидимый режим

Проверка запускается автоматически при отправке формы. Видимый блок CAPTCHA обычно не отображается, а пользователь взаимодействует с проверкой только в случае необходимости.

Для каждого сайта можно независимо настроить:

• активность модуля;

• Client Key и Server Key;

• режим работы;

• язык виджета;

• положение служебного элемента;

• исключения по URL;

• сообщение об ошибке;

• таймауты;

• политику обработки недоступности Yandex;

• журналирование.

Это позволяет использовать разные ключи и параметры SmartCaptcha для разных доменов одной установки «1С-Битрикс» или Корпоративный портал (1С-Битрикс24: Интернет-магазин + CRM).

Если клиентский скрипт Yandex SmartCaptcha не загрузился или при создании виджета возникла ошибка, модуль возвращает стандартную CAPTCHA Битрикс. Форма при этом остается доступной пользователю.

Для ошибок серверной проверки предусмотрены две политики:

• allow — продолжить обработку формы при временной недоступности сервиса Yandex;

• deny — считать проверку неуспешной и запретить обработку формы.

Политика allow повышает доступность сайта, а deny обеспечивает более строгий режим защиты.

Модуль автоматически обрабатывает формы, содержащие стандартные поля CAPTCHA Битрикс:

• captcha_sid или captcha_code;

• captcha_word или capcha_word.

Поддерживаются также поля в верхнем регистре и вложенные имена, например:

order[captcha_sid]

order[captcha_word]

Модуль не требует изменения стандартных компонентов Битрикс. Для нестандартных форм необходимо, чтобы в них присутствовали совместимые поля стандартной CAPTCHA.

В административной части доступна диагностика каждого сайта. Она позволяет проверить:

• активирован ли модуль;

• заполнен ли Client Key;

• заполнен ли Server Key;

• выбранный режим работы;

• адрес серверной проверки;

• политику обработки недоступности сервиса.

При включенном журналировании результаты проверок и технические ошибки записываются в стандартный журнал событий «1С-Битрикс». Значения токенов и секретных ключей в открытом виде в журнал не записываются.