1. Описание всех настроек
Путь: Настройки → Настройки продукта → Настройки модулей → Авторизация через MAX
(или пункт меню Настройки → Авторизация через MAX → Настройки).
| Опция | Назначение | |
|---|---|---|
| Включить авторизацию через 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 (по умолчанию /). |
| Опция | Назначение | |
|---|---|---|
| Длина кода | 4–8 цифр (по умолчанию 6). | |
| TTL кода (мин.) | Время жизни кода (по умолчанию 5). | |
| Макс. попыток ввода | После превышения код инвалидируется (по умолчанию 5). | |
| TTL токена привязки (мин.) | Срок действия токена в deep link (по умолчанию 30). | |
| Шаблон сообщения с кодом | Текст в MAX. Плейсхолдеры: #CODE#, #TTL#, #LOGIN#. |
| Опция | Назначение | |
|---|---|---|
| Требовать код 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 привязанному пользователю.
Список привязок:
- фильтры: 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
Поддержка осуществляется по будням с 8:00 до 17:00 по московскому времени. Скорость ответа зависит от загруженности команды и сложности вопроса, но в среднем составляет 1-2 рабочих дня.
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.
