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

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

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

• Яндекс ID OAuth 2.0. Код авторизации обменивается на access token на стороне сервера.
• Профиль Яндекса. CMS получает ID пользователя, имя, аватар и e-mail, если он доступен по выданным правам.
• Автоматическая регистрация. При первом успешном входе CMS создаёт пользователя и связывает его с Яндекс ID.
• Web и mobile-настройки. В манифесте есть поля для iOS и Android, чтобы владелец сайта мог заполнить требования кабинета Яндекс OAuth.

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

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

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

• Client ID: Идентификатор приложения из консоли Яндекс OAuth
• Client Secret: Секретный ключ приложения из консоли Яндекс OAuth Значение храните только в защищённых настройках ADWOS CMS.
• Redirect URI (мобильное приложение): Callback URI для мобильного приложения. По умолчанию adwos-mobile://auth/callback — добавьте это значение в список Callback URI в консоли Яндекса. Должно начинаться с уникальной для приложения схемы (не http/https).
• iOS App ID: Bundle ID и Team ID iOS-приложения через точку. Скопируйте это значение в поле «iOS Appid» в консоли Яндекса. ADWOS backend это поле не использует: оно нужно только для конфигурации Яндекс OAuth.
• iOS AppStore URL: Ссылка на iOS-приложение в App Store. Скопируйте это значение в поле «iOS AppStore URL» в консоли Яндекса.
• Android package name: Имя пакета Android-приложения. Скопируйте это значение в поле «Android package name» в консоли Яндекса.
• Android Google Play URL: Ссылка на Android-приложение в Google Play. Скопируйте это значение в поле «Android Google Play URL» в консоли Яндекса.
• Android SHA256 Fingerprint: SHA256-отпечаток подписи Android-приложения в формате 00:00:...:00. Скопируйте это значение в поле «SHA256 Fingerprints» в консоли Яндекса.

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

1. Откройте oauth.yandex.ru и создайте приложение типа «Веб-сервисы».
2. Включите доступ к данным профиля: логин, e-mail и информация о пользователе.
3. В Redirect URI добавьте значение из поля ниже. Адрес должен совпадать символ-в-символ.
4. Скопируйте Client ID и Client Secret в настройки ADWOS CMS.
5. Если используете мобильные приложения, заполните iOS и Android поля в кабинете Яндекс OAuth теми же значениями, которые указаны в настройках модуля.
6. Сохраните настройки и включите модуль.

Важно

Если в Яндекс OAuth уже зарегистрирован другой callback, например /auth/oauth-callback, укажите его в поле Redirect URI ниже. CMS примет вход по этому адресу, если параметр провайдера передан корректно.

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

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