Технические данные
- Опубликовано:
- 11.08.2026
- Обновлено:
- 03.09.2026
- Версия:
- 1.0.1
- Установлено:
- 50 - 99 раз
- Подходящие редакции:
- «Первый сайт», «Старт», «Стандарт», «Малый бизнес», «Бизнес», «Интернет-магазин + CRM»
- Адаптивность:
- Да
- Поддержка Композита:
- Да
- Совместимо с Сайты24
- Нет
Пользовательское соглашение
Описание
Модуль заменяет стандартную 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С-Битрикс». Значения токенов и секретных ключей в открытом виде в журнал не записываются.
| 1.0.1 (03.09.2026) | Небольшие улучшения модуля. |
| 1.0.0 (07.08.2026) | Небольшие улучшения модуля. |
| 0.0.2 (17.07.2026) | Небольшие улучшения модуля. |
Системные требования
Для работы модуля необходимы:
установленная система «1С-Битрикс: Управление сайтом» или Корпоративный портал (1С-Битрикс24: Интернет-магазин + CRM).
PHP версии 8.2 или выше;
доступ сайта к сервисам Yandex SmartCaptcha;
Client Key и Server Key, полученные в сервисе Yandex SmartCaptcha;
права администратора сайта.
Перед установкой рекомендуется создать резервную копию файлов и базы данных сайта стандартными средствами «1С-Битрикс».
Установка модуляУстановите решение через Маркетплейс «1С-Битрикс».
После загрузки решения:
Перейдите в административную часть сайта.
Откройте раздел:
Настройки → Настройки продукта → Модули
Найдите модуль «Установка Яндекс SmartCaptcha PRO».
Нажмите «Установить».
Дождитесь завершения установки.
Во время установки модуль:
регистрируется в системе «1С-Битрикс»;
регистрирует необходимые обработчики событий;
копирует JavaScript- и CSS-файлы;
создает первоначальные настройки.
Модуль устанавливается выключенным и не влияет на формы сайта до заполнения ключей и ручного включения.
Получение ключей Yandex SmartCaptchaПеред настройкой модуля создайте CAPTCHA в сервисе Yandex SmartCaptcha и получите:
Client Key — публичный клиентский ключ, используемый для отображения виджета;
Server Key — секретный серверный ключ, используемый для проверки полученного токена.
При создании CAPTCHA укажите домены сайтов, на которых будет использоваться модуль.
Для многосайтовой установки можно использовать отдельные ключи для каждого сайта.
Настройка модуляПосле установки перейдите в раздел:
Настройки → Настройки продукта → Настройки модулей → Установка Яндекс SmartCaptcha PRO
На странице будет отображен список сайтов текущей установки «1С-Битрикс».
Для нужного сайта выберите действие «Редактировать».
Основные параметрыВключить модуль
Выберите «Да», чтобы активировать замену стандартной CAPTCHA на выбранном сайте.
Включайте модуль после заполнения Client Key и Server Key.
Клиентский ключ — Client KeyУкажите публичный ключ Yandex SmartCaptcha.
Он используется браузером для загрузки и отображения виджета.
Серверный ключ — Server KeyУкажите секретный ключ Yandex SmartCaptcha.
Он используется сервером сайта для проверки токена пользователя. Не размещайте Server Key в шаблонах сайта и не передавайте его третьим лицам.
Режим виджетаДоступны два режима:
Видимый — виджет SmartCaptcha отображается непосредственно в форме;
Невидимый — проверка запускается при попытке отправить форму.
Для первоначальной настройки рекомендуется использовать видимый режим. После проверки работы форм можно переключить модуль в невидимый режим.
Язык виджетаЗначение auto включает автоматический выбор языка.
Также можно принудительно выбрать один из поддерживаемых языков, например:
ru;
en;
be;
kk;
tt;
uk;
uz;
tr.
Параметр определяет положение служебного элемента Yandex SmartCaptcha в невидимом режиме.
Например:
bottom-right;
bottom-left;
bottom-center;
top-right.
По умолчанию используется значение bottom-right.
Дополнительные параметрыМаски исключений
Позволяют отключить модуль на отдельных страницах.
Каждая маска указывается с новой строки. Символ * заменяет любое количество символов.
Примеры:
/personal/*/catalog/import/
/services/legacy-form/
На страницах, соответствующих указанным маскам, SmartCaptcha не подключается и продолжает работать стандартная CAPTCHA Битрикс.
Сообщение об ошибкеМожно указать текст, который будет отображаться при неуспешной проверке пользователя.
Если поле оставить пустым, используется стандартное сообщение:
«Не удалось подтвердить, что вы не робот. Пройдите проверку еще раз».
Таймаут серверной проверкиОпределяет, сколько времени сайт будет ожидать ответ от сервера Yandex.
Допустимые значения: от 1 до 10 секунд.
Значение по умолчанию: 2 секунды.
Таймаут загрузки JavaScriptОпределяет максимальное время ожидания загрузки клиентского скрипта Yandex SmartCaptcha.
Допустимые значения: от 1000 до 15000 миллисекунд.
Значение по умолчанию: 5000 миллисекунд.
Если скрипт не загрузится за указанное время, модуль восстановит стандартную CAPTCHA Битрикс.
Политика при недоступности YandexДоступны два режима:
allow — продолжить обработку формы при временной недоступности серверной проверки Yandex;
deny — отклонить отправку формы, если серверную проверку выполнить невозможно.
Для сайтов, где важнее непрерывная доступность форм, рекомендуется allow.
Для форм с повышенными требованиями к защите рекомендуется deny.
ЖурналированиеПри включении параметра сведения о проверках и технических ошибках записываются в стандартный журнал событий «1С-Битрикс».
Просмотреть записи можно через действие «Журнал» на странице настроек модуля или в разделе:
Настройки → Инструменты → Журнал событий
Сохранение настроекПосле заполнения параметров нажмите:
«Сохранить» — сохранить настройки и вернуться к списку сайтов;
«Применить» — сохранить настройки и остаться на текущей странице.
Настройки сохраняются отдельно для каждого сайта.
Проверка установкиПосле сохранения настроек:
Откройте действие «Диагностика» для настраиваемого сайта.
Убедитесь, что модуль активен.
Убедитесь, что Client Key и Server Key отмечены как заполненные.
Откройте публичную страницу со стандартной CAPTCHA Битрикс.
Проверьте, что вместо изображения с кодом отображается Yandex SmartCaptcha.
Успешно пройдите проверку и отправьте форму.
Попробуйте отправить форму без прохождения проверки.
Проверьте работу AJAX-форм, всплывающих окон и других динамических форм.
При включенном журналировании проверьте записи в журнале событий.
Проверку рекомендуется выполнить для следующих форм, если они используются на сайте:
регистрация;
восстановление пароля;
обратная связь;
комментарии;
отзывы;
оформление заказа;
пользовательские формы со стандартной CAPTCHA Битрикс.
Модуль автоматически создает контейнер:
.delement-yandexcaptcha-containerВ большинстве шаблонов дополнительная настройка не требуется.
При необходимости внешний вид и отступы можно изменить в CSS шаблона сайта. Не рекомендуется изменять внутреннюю структуру самого виджета Yandex SmartCaptcha.
Возможные причины отсутствия виджетаSmartCaptcha не будет отображаться, если:
модуль выключен для текущего сайта;
не заполнен Client Key или Server Key;
текущий адрес соответствует маске исключения;
форма не содержит стандартных полей CAPTCHA Битрикс;
страница относится к административной части сайта;
отсутствует доступ к сервисам Yandex SmartCaptcha;
домен сайта не разрешен в настройках ключа.
При ошибке загрузки SmartCaptcha модуль должен восстановить стандартную CAPTCHA Битрикс, чтобы пользователь сохранил возможность отправить форму.
Перед обращением в службу поддержки Цифрового Элемента, пожалуйста, ознакомьтесь с Документацией по настройке и работе 1С-Битрикс для пользователя.
Используя описание модуля и документацию 1С-Битрикс, вы сможете самостоятельно настроить решение, найти ответы на часто задаваемые вопросы и устранить большинство ошибок.
Поддержка осуществляется через форму на сайте https://d-element.ru/support/.
Техподдержка не осуществляется по телефону, Skype, Telegram и другим мессенджерам и социальным сетям.
Техническая поддержка:
1) Консультация по работе и установке модуля в рамках типового функционала осуществляется бесплатно!
2) Установка и настройка решения на вашем проекте осуществляется по запросу за дополнительную оплату.
При каждом обращении обязательно предоставьте следующие данные:
- Адрес сайта.
- Логин и пароль для доступа к 1С-Битрикс с правами администратора. Как предоставить доступ сотруднику техподдержки?
- Адрес сервера, логин и пароль для доступа к сайту по FTP или SSH с правами на чтение и запись.
- Четкое описание проблемы и алгоритм действий для ее воспроизведения.
- Снимки экрана или видеозапись подтверждения ошибки. Обзор программ для создания скриншотов и скринкастов
Выполнение этих рекомендаций ускорит обработку вашей заявки.
Поддержка осуществляется по будням с 07:00 до 16:00 по московскому времени. Скорость ответа зависит от загруженности команды и сложности вопроса, но в среднем составляет 2-3 рабочих дня.
Другие решения разработчика
© 2001-2026 «Битрикс», «1С-Битрикс». Работает на 1С-Битрикс: Управление сайтом.