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

Модуль добавляет кнопку «Войти через Telegram». Пользователь подтверждает вход в Telegram, а ADWOS CMS получает проверенный профиль без пароля и SMS.

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

• Актуальный Telegram OpenID Connect. Основной режим использует authorization code flow с PKCE, endpoint oauth.telegram.org/auth, endpoint oauth.telegram.org/token и проверку id_token по JWKS.
• Профиль пользователя. CMS получает стабильный идентификатор, имя, username и аватар, если пользователь разрешил эти данные.
• Телефон по согласию. При включённом scope phone Telegram может вернуть подтверждённый номер в id_token.
• Разрешение на сообщения. Scope telegram:bot_access позволяет связать вход с последующими уведомлениями от бота.
• Совместимость со старыми сайтами. Legacy Login Widget через bot_token продолжает работать, если сайт уже был настроен раньше.

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

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

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

• Client ID: Client ID из @BotFather, раздел Bot Settings, Web Login. Используется в актуальном Telegram OIDC flow.
• Client Secret: Client Secret из @BotFather, раздел Bot Settings, Web Login. Хранится как секрет и используется только сервером. Значение храните только в защищённых настройках ADWOS CMS.
• Bot Token (legacy): Legacy-настройка для старого Login Widget. Для новых установок используйте Client ID и Client Secret. Значение храните только в защищённых настройках ADWOS CMS.
• Username бота (legacy): Legacy-настройка для старого Login Widget. Укажите username бота без @, если не используете OIDC.
• Запрашивать номер телефона: Запросить scope phone. Telegram вернёт подтверждённый номер только если пользователь даст согласие.
• Запрашивать разрешение на сообщения: В OIDC-режиме добавляет scope telegram:bot_access; в legacy-режиме включает request_access=write. Используйте только если сайт действительно отправляет уведомления через Telegram.
• Иконка модуля (свой SVG/PNG, опционально): Загрузите свой логотип. Если не задано — используется фирменная иконка по умолчанию. Рекомендуется квадратный SVG.

Как настроить рекомендуемый OIDC-режим

1. Откройте @BotFather в Telegram и выберите бота, который представляет ваш сайт.
2. В Bot Settings откройте Web Login и добавьте Allowed URLs: домен сайта и точный Redirect URI из настроек модуля.
3. Скопируйте Client ID и Client Secret из Web Login в поля модуля ADWOS CMS.
4. Включите только нужные scope: phone для номера телефона, telegram:bot_access для разрешения писать пользователю.
5. Сохраните настройки, включите модуль и проверьте, что кнопка Telegram появилась в форме входа.

Legacy-режим

Если заполнены только Bot Token и Username, модуль использует старый Telegram Login Widget. Для новых установок используйте Client ID и Client Secret.

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

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