База знаний · 1С-Битрикс

Captcha на веб-формах

Защита форм обратной связи от спам-ботов средствами платформы

CAPTCHA — это проверка «человек или бот», которая защищает веб-формы 1С-Битрикс от автоматических рассылок спама. Включается она на уровне конкретной формы и не требует стороннего кода.

Настройка находится в Контент → Веб-формы → Настройка форм — откройте нужную форму и перейдите на вкладку Настройки, параметр «Показывать CAPTCHA при заполнении формы».

Что такое CAPTCHA и когда её включать

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

Встроенная CAPTCHA в 1С-Битрикс полезна прежде всего для публичных форм, доступных без авторизации:

формы обратной связи и «Задать вопрос»;
заявки, расчёт стоимости, запись на услугу;
формы регистрации и подписки.

Для форм, доступных только авторизованным сотрудникам, CAPTCHA обычно избыточна и только мешает — там её включать не стоит.

Как включить CAPTCHA на веб-форме

CAPTCHA задаётся для каждой формы отдельно. Порядок действий:

Перейдите в Контент → Веб-формы → Настройка форм.
Откройте нужную форму на редактирование (или создайте новую).
На вкладке Настройки найдите параметр «Показывать CAPTCHA при заполнении формы» и установите флажок.
Сохраните форму кнопкой Сохранить.

После сохранения на публичной части формы появится картинка с кодом и поле для его ввода. Если посетитель введёт код неверно, форма не отправится и покажет сообщение об ошибке.

Вывод CAPTCHA в шаблоне компонента

Флажок в настройках формы отвечает за логику проверки, но само поле должно быть выведено в шаблоне. В стандартном компоненте bitrix:form.result.new за это отвечает блок с выводом картинки и полем ввода.

Если вы правили шаблон вручную, убедитесь, что в нём присутствуют:

картинка CAPTCHA — тег <img> со ссылкой на /bitrix/tools/captcha.php с параметром captcha_sid;
скрытое поле captcha_sid с идентификатором кода;
текстовое поле captcha_word для ввода символов.

Если этих элементов нет, CAPTCHA включена, но на странице не видна — форма при этом будет считать проверку не пройденной.

Настройка вида и сложности картинки

Параметры генерации картинки задаются в модуле «Проактивная защита». Путь: Настройки → Проактивная защита → CAPTCHA.

Параметр	Назначение
Набор символов	Какие символы используются в коде (цифры, буквы, регистр).
Длина кода	Количество символов на картинке.
Шрифт и искажения	Уровень зашумления и деформации для усложнения распознавания.
Цвета	Цвет фона, символов и помех.

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

CAPTCHA не только на веб-формах

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

Регистрация пользователей — в настройках модуля «Главный модуль» можно включить CAPTCHA при регистрации нового пользователя;
Восстановление пароля и авторизация — CAPTCHA появляется автоматически после нескольких неудачных попыток входа;
Форум и комментарии — в соответствующих модулях есть отдельные флажки показа CAPTCHA для анонимных посетителей.

Все они используют один и тот же механизм генерации картинки из «Проактивной защиты».

Частые ошибки и их решение

Наиболее распространённые проблемы с CAPTCHA на веб-формах:

Картинка не отображается (пустой квадрат). Чаще всего не работает библиотека GD в PHP. Проверьте её наличие в Настройки → Инструменты → Проверка системы. Также причиной бывает лишний вывод в init.php до генерации изображения.
Код всегда неверный, хотя введён правильно. Обычно теряется параметр captcha_sid при кэшировании страницы. Отключите кэширование блока с формой или исключите captcha_sid из кэша.
CAPTCHA включена, но поля нет. В кастомном шаблоне не выведены элементы вывода картинки и поля ввода — добавьте их вручную.
Спам проходит несмотря на CAPTCHA. Убедитесь, что флажок стоит именно у нужной формы, а не только в шаблоне; проверьте, не отключён ли модуль «Проактивная защита».
Картинка кэшируется браузером. Символы не меняются между отправками — добавьте к URL картинки уникальный параметр или проверьте заголовки кэширования.

Итог

Встроенная CAPTCHA 1С-Битрикс — быстрый способ снизить поток спама через публичные веб-формы без стороннего кода. Достаточно включить флажок в настройках формы и убедиться, что поле выводится в шаблоне.

Держите баланс: слишком сложная картинка отпугивает живых посетителей. Для форм за авторизацией CAPTCHA не нужна, а для приёма большого потока заявок стоит дополнительно продумать серверную фильтрацию и защиту от повторных отправок.

Частые вопросы

Где включается CAPTCHA для конкретной веб-формы?

В разделе Контент → Веб-формы → Настройка форм. Откройте форму, перейдите на вкладку Настройки и установите флажок «Показывать CAPTCHA при заполнении формы», затем сохраните форму.

Почему картинка CAPTCHA не отображается?

Чаще всего в PHP не установлена или отключена графическая библиотека GD. Проверьте её в разделе Настройки → Инструменты → Проверка системы. Ещё одна причина — лишний вывод текста в init.php до генерации изображения.

Почему код всегда считается неверным?

Обычно проблема в кэшировании страницы: параметр captcha_sid сохраняется в кэше и перестаёт соответствовать новой картинке. Отключите кэширование блока с формой или исключите captcha_sid из кэша.

Можно ли изменить сложность и вид картинки?

Да. Параметры набора символов, длины кода, шрифта, искажений и цветов задаются в разделе Настройки → Проактивная защита → CAPTCHA. Не делайте картинку чрезмерно сложной, чтобы не мешать реальным посетителям.

Нужна ли CAPTCHA на формах для авторизованных пользователей?

Как правило, нет. Если форма доступна только вошедшим сотрудникам, CAPTCHA избыточна и лишь усложняет заполнение. Её имеет смысл включать на публичных формах, доступных без авторизации.

Услуги по теме

Поможем с настройкой и поддержкой 1С-Битрикс

Поможем с настройкой, доработкой и поддержкой 1С-Битрикс.