Настройка модуля «Авторизация MAX»

Модуль добавляет кнопку «Войти через MAX». Авторизация работает через MAX Mini App: пользователь открывает сайт через бота в MAX и подтверждает вход одним действием.

Что получает CMS

• Подписанные данные MAX Mini App. CMS получает initData от клиента и проверяет подпись на сервере.
• Профиль MAX. Имя, username и аватар приходят из профиля пользователя, если они доступны в MAX.
• Защита от подмены. initData проверяется через HMAC-SHA256 по алгоритму MAX WebAppData.
• Автоматическая регистрация. При первом успешном входе CMS создаёт пользователя и связывает его с MAX.

Установка в ADWOS CMS

• Откройте админ-панель сайта под пользователем с правами администратора.
• В разделе «Каталог» откройте «Маркетплейс» и найдите модуль по названию.
• Нажмите «Установить». Если модуль уже установлен, откройте его карточку.
• Откройте настройки модуля, заполните обязательные поля и сохраните изменения.
• Включите модуль и проверьте, что кнопка входа появилась в форме авторизации.

Поля в настройках модуля

• Bot Token: Токен бота с business.max.ru. Откройте настройки бота, найдите раздел интеграции и получите Bot Token. Это длинная секретная строка с точкой посередине. Значение храните только в защищённых настройках ADWOS CMS.
• Username бота: Username вашего MAX-бота (без @). На business.max.ru виден под именем бота, например id2311352224_bot. Используется для построения deep-link к мини-приложению.
• Иконка модуля (свой SVG/PNG, опционально): Загрузите свой логотип. Если не задано — используется фирменная иконка по умолчанию. Рекомендуется квадратный SVG.

Как настроить

1. Откройте business.max.ru под аккаунтом организации.
2. В разделе «Чат-боты и мини-приложения» создайте нового бота или выберите существующего.
3. В настройках бота получите Bot Token.
4. В настройках мини-приложения укажите HTTPS-адрес сайта ADWOS CMS.
5. Скопируйте username бота без символа @.
6. Введите Bot Token и username бота в настройках модуля, сохраните изменения и включите модуль.

Важно

Данные initData старше одного часа отклоняются. Это защищает вход от повторного использования старых данных авторизации.

Проверка после включения

• Откройте страницу входа в приватном окне браузера.
• Убедитесь, что кнопка провайдера отображается и открывает официальный домен авторизации.
• Проверьте, что Redirect URI в кабинете провайдера совпадает со значением в ADWOS CMS полностью.
• Полный вход проверяйте после активации ключей провайдера. Без рабочих ключей модуль должен показывать ошибку настройки, а не ломать страницу входа.