Авторизация через MAX (EcomLabs)

Бесплатно

Установить

В наличии

Официальные лицензии

Описание

Установка

Поддержка

1. Описание всех настроек

Путь: Настройки → Настройки продукта → Настройки модулей → Авторизация через MAX
(или пункт меню Настройки → Авторизация через MAX → Настройки).

1.1. Вкладка «MAX» (бот и webhook)

Опция		Назначение
Включить авторизацию через MAX		Главный выключатель. Если выключен, API-запросы к MAX не выполняются.
Access token бота MAX		Токен бота из кабинета MAX.
Имя бота		Username бота (без @). Нужен для deep link автопривязки. Можно заполнить кнопкой «Проверить бота».
Секрет webhook		Если задан — сверяется с заголовком X-Max-Bot-Api-Secret / X-Webhook-Secret (только если заголовок пришёл).
URL API MAX		По умолчанию https://platform-api2.max.ru.
Отключить проверку SSL		Только для отладки.
Публичный URL сайта		https://example.com без хвоста. Используется для сборки URL webhook за reverse-proxy.
URL webhook		{PUBLIC_SERVER_URL или текущий хост}/bitrix/tools/ecl_maxauth_webhook.php
Шаблон deep link		Плейсхолдеры #BOT#, #TOKEN#. По умолчанию https://max.ru/#BOT#?start=#TOKEN# — после подстановки path-style deep link для bot_started.payload.
Редирект после входа		Куда вести после успешного verify_code (по умолчанию /).

1.2. Вкладка «Коды»

Опция		Назначение
Длина кода		4–8 цифр (по умолчанию 6).
TTL кода (мин.)		Время жизни кода (по умолчанию 5).
Макс. попыток ввода		После превышения код инвалидируется (по умолчанию 5).
TTL токена привязки (мин.)		Срок действия токена в deep link (по умолчанию 30).
Шаблон сообщения с кодом		Текст в MAX. Плейсхолдеры: #CODE#, #TTL#, #LOGIN#.

1.3. Вкладка «2FA»

Опция		Назначение
Требовать код MAX после входа по паролю		Если включен и у пользователя есть активная привязка: после Authorize → Logout → редирект на 2FA.
URL страницы 2FA		Страница с ecl:maxauth. Если пусто — берётся AUTH_REDIRECT + ?max_2fa=Y&user_id=….

На странице настроек также есть ссылки на Инструменты и Привязки.

2. Страницы в админке

Меню: Настройки → Авторизация через MAX.

2.1. Настройки

Стандартная страница модуля (settings.php?mid=ecl.maxauth) — см. выше.

2.2. Инструменты (ecl_maxauth_tools.php)

Вкладка Webhook

URL webhook и имя бота (readonly).
Проверить бота — GET /me, при успехе пишет MAX_BOT_NAME.
Подписать webhook — подписка на message_created, bot_started.
Статус webhook — только «подписан / не подписан» для нашего URL.
Удалить webhook.

Вкладка Привязка

Пользователь сайта — виджет Битрикс.
MAX user_id — ручной ввод.
Привязать вручную — запись в БД (недоступно, если уже привязан).
Отвязать — статус D (активна, если привязан).
Привязать автоматически — токен + deep link, открытие в новой вкладке (без отображения ссылки на странице).
Обновить статус — проверка привязки.

Вкладка Тест

Пользователь (виджет Битрикс) + текст.
Отправить тест — сообщение в MAX привязанному пользователю.

2.3. Привязки (ecl_maxauth_bindings.php)

Список привязок:

фильтры: USER_ID, MAX_USER_ID, STATUS;
колонки: ID, пользователь (ссылка на user_edit), MAX user_id, статус, число входов, даты;
действия: отвязать (одиночное и групповое), переход в карточку пользователя.

3. Вкладка на user_edit

Вкладка «MAX Auth»:

Статус — привязан / не привязан, MAX user_id, число входов через MAX, дата последнего входа;
поле MAX user_id;
Привязать вручную — по введённому MAX user_id;
Отвязать;
Привязать автоматически — deep link в новом окне;
Обновить статус — проверка привязки.

Если привязка уже есть, кнопки ручной и автопривязки неактивны; доступны отвязка и обновление статуса.

4. Компоненты

4.1. ecl:maxauth — вход / 2FA

Назначение: заменить или дополнить стандартную авторизацию кодом из MAX.

$APPLICATION->IncludeComponent('ecl:maxauth', '', [

    'AUTH_RESULT_PATH' => '/',  // куда после успешного входа

    'SHOW_TITLE' => 'Y',

]);

Параметры:

Редирект после входа (по умолчанию /)
Показывать заголовок (Вкл / Выкл)

Возможности:

Шаг 1: логин / email / телефон → request_code → код уходит в MAX привязанному пользователю.
Шаг 2: ввод кода → verify_code → Authorize + редирект.
Режим 2FA: при REQUIRE_MAX_AFTER_PASSWORD и сессии ECL_MAXAUTH[2FA_UID] (или query max_2fa + user_id) сразу шаг кода, автозапрос кода, request_code_2fa / verify_code_2fa.
Счётчик до истечения кода.
Счётчик попыток «N из M»; при ошибке обновляется с сервера.
По истечении времени / лимита попыток — блокировка входа, кнопка повторной отправки кода.

4.2. ecl:maxauth.bind — привязка в ЛК

Назначение: блок в личном кабинете / профиле на витрине.

$APPLICATION->IncludeComponent('ecl:maxauth.bind', '', [

    'SHOW_TITLE' => 'Y',

]);

Параметры:

Показывать заголовок (Вкл / Выкл)

Возможности (только для текущего авторизованного пользователя):

статус привязки и MAX user_id;
Привязать вручную — ввод MAX user_id;
Привязать автоматически — токен + открытие deep link в новой вкладке;
Отвязать;
Обновить статус — проверка привязки.

Установка

Войти в административную часть сайта под пользователем с правами администратора.
Открыть раздел Marketplace:
• «Marketplace → Каталог решений» — для установки из каталога;
• или «Marketplace → Установка решений» / установка из загруженного пакета (если решение устанавливается из файла/архива — в зависимости от редакции).
Найти решение «Авторизация через MAX» партнёра ООО «Иком Лабс» (модуль ecl.maxauth), либо загрузить поставленный пакет решения.
Запустить установку модуля ecl.maxauth.
Дождаться завершения.
После установки

Заполните настройки модуля (см. ниже).

Настройки → Авторизация через MAX → Инструменты:
«Проверить бота» (подтянется username бота);
«Подписать webhook».
Привяжите тестового пользователя (автоматически или вручную).
На странице входа разместите компонент ecl:maxauth, в ЛК — ecl:maxauth.bind.

Удаление: Модули → Удалить. На шаге удаления можно оставить таблицы (галочка «Сохранить таблицы»).

Требования: Bitrix (D7), PHP с password_hash / random_bytes, публичный HTTPS-URL для webhook.

Краткий сценарий запуска

Создать бота MAX, получить token.
Установить модуль, включить MAX_ENABLED, указать token и PUBLIC_SERVER_URL.
Инструменты → Проверить бота → Подписать webhook.
Привязать пользователя (авто или вручную).
Вывести ecl:maxauth на странице входа.
При необходимости — ecl:maxauth.bind в ЛК и/или 2FA после пароля.

Webhook endpoint: /bitrix/tools/ecl_maxauth_webhook.php

По всем вопросам просим обращаться через сайт или по почте helpdesk@ecom-labs.ru

Поддержка осуществляется по будням с 8:00 до 17:00 по московскому времени. Скорость ответа зависит от загруженности команды и сложности вопроса, но в среднем составляет 1-2 рабочих дня.