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

Модуль добавляет кнопку «Войти через Mail.ru». Пользователь входит через почтовый профиль, а ADWOS CMS получает данные через OAuth 2.0 платформы «Сайты».

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

• OAuth 2.0 вход. Код авторизации обменивается на access token на стороне сервера.
• Профиль Mail.ru. CMS получает ID пользователя, имя, e-mail и аватар.
• Подтверждение владения сайтом. Mail.ru проверяет файл receiver.html, который должен открываться на вашем домене.
• Автоматическая регистрация. При первом успешном входе CMS создаёт пользователя и связывает его с Mail.ru.

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

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

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

• receiver.html (загрузите файл от Mail.ru): Файл receiver.html от Mail.ru для верификации сайта. После загрузки он будет доступен по адресу https://ваш-сайт/receiver.html.
• Client ID (ID сайта): «ID сайта» из настроек на api.mail.ru/sites/my (числовой, например 791747)
• Client Secret (Секретный ключ): «Секретный ключ» из настроек сайта Mail.ru — используется и для обмена кода на access_token, и для подписи запроса профиля пользователя Значение храните только в защищённых настройках ADWOS CMS.
• Иконка модуля (свой SVG/PNG, опционально): Загрузите свой логотип. Если не задано — используется фирменная иконка по умолчанию. Рекомендуется квадратный SVG.

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

1. Откройте api.mail.ru/sites/my и добавьте сайт.
2. На шаге подтверждения скачайте файл receiver.html.
3. Загрузите этот файл в поле «receiver.html» в настройках модуля. CMS будет отдавать его по адресу /receiver.html.
4. В кабинете Mail.ru укажите адрес страницы receiver.html в формате https://ваш-сайт/receiver.html и сохраните настройки.
5. Скопируйте ID сайта в поле Client ID, а секретный ключ в поле Client Secret.
6. Сохраните настройки ADWOS CMS и включите модуль.

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

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