Telegram Mini App

Модуль BPM2B Telegram Mini App добавляет в платформу BPM2B серверную часть фреймворка для Telegram Mini App: метод аутентификации, который принимает init data от Telegram WebApp и валидирует подпись по стандарту Telegram. Это фундамент для интеграций — сам модуль не содержит готового пользовательского UI Mini App, он обеспечивает безопасный обмен сессиями.

Основные функциональные возможности:

• Метод аутентификации TelegramMiniApp: API-only метод авторизации, регистрируется в платформе через authenticationMethods и активируется на API-эндпоинтах.
• Проверка подписи Telegram: данные передаются в заголовке X-TelegramMiniApp-Authorization; подпись считается как HMAC-SHA256 от отсортированных init data с секретом HMAC-SHA256(bot_token, "WebAppData") — точно по спецификации Telegram WebApp.
• Контроль свежести запроса: поле auth_date валидируется с максимальным возрастом 24 часа — устаревшие init data отклоняются.
• Привязка к ChatAccount: заголовок app-id идентифицирует бота: бот должен существовать как запись ChatAccount в Chat Center и быть активным.
• Интеграция с пользователями: on-success-хук TelegramUserSetToken связывает Telegram-пользователя с пользователем платформы и выдаёт ему access token.

Модуль предназначен для команд, которые разрабатывают собственное Telegram-приложение (Mini App) поверх данных платформы. Типичный сценарий: фронтенд Mini App открывается внутри Telegram, передаёт init data в API платформы — модуль валидирует подпись и заводит сессию пользователя. Зависит от модуля BPM2B Chat Center (для управления ботами через ChatAccount).