Двухфакторная авторизация (Google / Яндекс.Ключ) (EcomLabs)

Двухфакторная авторизация (Google / Яндекс.Ключ) (EcomLabs), ver. 1.0.0

Рейтинг:
Бесплатно
Работает на редакциях Битрикс:
Первый сайтСтартСтандартМалый бизнесБизнес
В случае покупки "Двухфакторная авторизация (Google / Яндекс.Ключ) (EcomLabs)" у нас, мы предложим вам "Бесплатную базовую установку" на ваш сервер или комплексную услугу по настройке сайта под ключ
Помощь, техподдержка
Нужна помощь?
Поможем с настройкой "Двухфакторная авторизация (Google / Яндекс.Ключ) (EcomLabs)"
Двухфакторная авторизация
 

   TOTP (RFC 6238) с поддержкой Яндекс.Ключ, Google Authenticator, Microsoft Authenticator и других приложений. Несколько устройств, резервные коды, обязательность по группам, админка и публичная часть.

1. Описание работы

 Назначение
 

   Модуль добавляет второй фактор входа по стандарту TOTP: после логина и пароля пользователь вводит одноразовый код из приложения-аутентификатора (или резервный код). Работает в административной части и на витрине, не требует обязательного модуля «Проактивная защита».

Типовые сценарии
 
  1. Вход с уже подключённой 2FA. Пользователь вводит логин/пароль → система открывает страницу подтверждения → ввод 6-значного кода (или резервного) → сессия помечается как прошедшая 2FA → редирект на исходный URL (админка или сайт).
  2. Обязательная 2FA без устройств. Если пользователь входит в группу из настройки «обязательные группы», а устройств ещё нет, после пароля его направляют на страницу подключения (QR + два кода подряд).
  3. Добровольное подключение. Через компонент ecl:yandex2fa.setup в личном кабинете или через URL setup: генерация секрета, QR otpauth://totp/..., подтверждение двумя кодами, выдача резервных кодов один раз.
  4. Несколько устройств. На аккаунт можно добавить несколько аутентификаторов (лимит настраивается). Удаление/отключение с учётом политики «обязательна для группы».
  5. Повторный вход в срок доверия. После успешной 2FA действует trust-сессия (минуты из настроек), чтобы не запрашивать код на каждом хите в рамках TTL.

Безопасность (кратко)

 
  • Секреты устройств хранятся на сервере в защищённом виде; резервные коды — только как хеши (plaintext показывается один раз при выдаче).
  • Окно проверки TOTP (±N периодов по 30 сек), защита от повторного использования одного шага (replay).
  • Лимит попыток ввода и временная блокировка по настройкам.
  • Опционально — приём кода только по HTTPS.
  • Доверие после 2FA — в отдельной таблице модуля, не в b_option.
  • Критичные действия пишутся в журнал модуля.

 Служебные URL
Назначение Путь по умолчанию
Ввод кода (challenge) /bitrix/tools/ecl_yandex2fa_auth.php
Подключение 2FA /bitrix/tools/ecl_yandex2fa_setup.php
AJAX setup /bitrix/tools/ecl_yandex2fa_setup_ajax.php

   URL challenge/setup можно переопределить в настройках модуля. Для встраивания в шаблон сайта удобнее компоненты (см. раздел 3).

2. Настройки и страницы в админке

 2.1. Настройки модуля
 

   Путь: Настройки → Настройки продукта → Настройки модулей → Двухфакторная авторизация (Google / Яндекс.Ключ) (EcomLabs) (или пункт меню модуля «Настройки»).

Параметр Смысл · значение по умолчанию
Модуль включён Глобальный выключатель 2FA без удаления модуля. По умолчанию N (после установки нужно включить).
Только HTTPS Не принимать проверку кода по HTTP. По умолчанию N.
Группы, для которых 2FA обязательна Мультивыбор групп пользователей. Для этих групп без активного устройства вход не завершится — увод на setup. По умолчанию группа администраторов (1).
Окно проверки, периодов ± Допуск по времени TOTP (период 30 сек). Обычно 1.
Алгоритм HMAC Для новых подключений: SHA-1 / SHA-256 / SHA-512. Google Authenticator — только SHA-1. По умолчанию sha1.
Количество резервных кодов 8–20 штук при enroll / перевыпуске. По умолчанию 10.
Максимум устройств на пользователя 1–20. По умолчанию 5.
Срок доверия сессии после 2FA, минут TTL trust после успешного кода. По умолчанию 720 (12 часов).
Попыток ввода до блокировки Неуспешные verify подряд. По умолчанию 5.
Блокировка, секунд Пауза после исчерпания попыток. По умолчанию 900.
Издатель (issuer) Подпись в приложении. Пусто — имя сайта из настроек main.
ASCII-лейблы в QR Транслит кириллицы в label/issuer для приложений с кривой UTF-8 (например Drop Authenticator). Google / Яндекс.Ключ обычно UTF-8 переваривают.
URL страницы ввода кода По умолчанию /bitrix/tools/ecl_yandex2fa_auth.php.
URL страницы подключения 2FA По умолчанию /bitrix/tools/ecl_yandex2fa_setup.php.
Инструкция для пользователя Текст подсказок; пусто — встроенная инструкция Google Authenticator + Яндекс.Ключ.
2.2. Пользователи с 2FA
 

   Пункт меню модуля: Пользователи c 2FA.

  • Колонки: ID, логин, имя, активность 2FA, число устройств, дата, использование резервных кодов и т.п.
  • Действие сброса 2FA пользователя (с подтверждением) — устройства и recovery очищаются, trust сбрасывается.
2.3. Журнал
 

   Пункт меню: Журнал. События enroll, verify, recovery, ошибки, сбросы. Колонки: дата, пользователь, действие, IP, описание.

2.4. Меню
 

   Раздел в админ-меню Bitrix с пунктами: Настройки, Пользователи, Журнал.

3. Описание компонентов

 3.1. ecl:yandex2fa.auth
 

   Блок подтверждения входа / статуса 2FA. Можно ставить на любую страницу (в т.ч. вместо отдельного tools-URL).

  • Гость — предложение сначала войти логином и паролем.
  • Нужен код — форма TOTP / recovery.
  • Уже verified — сообщение, что повторный ввод не нужен (если включено параметром).
  • 2FA не требуется / модуль выключен — соответствующие статусы.

   Параметры (основные):

  • AJAX_MODE — режим AJAX, по умолчанию Y.
  • SHOW_VERIFIED — показывать блок, если вход уже подтверждён.
  • Кеш: стандартные CACHE_TYPE / CACHE_TIME.
3.2. ecl:yandex2fa.setup
 

   Подключение и управление устройствами: список, «Подключить» / «Добавить устройство», QR, два кода, резервные коды (один раз), удаление устройства, перевыпуск recovery, отключение 2FA (если разрешено политикой группы).

  • Работает автономно на странице профиля /tools/setup.
  • AJAX_MODE по умолчанию Y — действия через ecl_yandex2fa_setup_ajax.php.
  • На tools-странице — центрированная карточка и кнопка «Вернуться на сайт».
  • Поддержка композита.
   Рекомендация: в личном кабинете разместить ecl:yandex2fa.setup; challenge при входе можно оставить на tools-URL или вывести ecl:yandex2fa.auth на кастомной странице входа.
Разработчик eCom Labs
Опубликовано 28.10.2026
Версия 1.0.0
Установлено Менее 50 раз
Адаптивность Да
Поддержка Композита Да
Подходящие редакции Первый сайт, Старт, Стандарт, Малый бизнес, Бизнес
Бесплатно Да
Пробный период Нет
Рекомендуем
Для корректной работы сайта мы используем файлы куки.
Принять