Skip to content

Add WebAppDataValidator for mini app init data - #48

Merged
BushlanovDev merged 1 commit into
BushlanovDev:masterfrom
smotim:feat/web-app-data-validation
Oct 28, 2026
Merged

BushlanovDev merged 1 commit into
BushlanovDev:masterfrom
smotim:feat/web-app-data-validation

Conversation

@smotim

@smotim smotim commented Oct 27, 2026

Copy link
Copy Markdown
Contributor

Проверка данных мини-приложения MAX на сервере — то, что мини-приложение передаёт из window.WebApp.initData. Без неё сервер не может доверять пользователю из этих данных, а в PHP готовой проверки для MAX пока нет (есть в официальном Go-клиенте — ValidateInitData).

$data = (new WebAppDataValidator('YOUR_BOT_API_TOKEN'))->validate($initData);
$data->user['id'];
$data->startParam;
  • WebAppDataValidator::validate() — подпись по документации MAX (HMAC-SHA256 отсортированных key=value с ключом HMAC-SHA256("WebAppData", токен)), затем срок: сутки по умолчанию, maxAge: null выключает. Отказ — SecurityException, как у проверки вебхука.
  • Строка разбирается вручную, а не parse_str(): тот превращает hash[]= в массив и меняет точки и пробелы в ключах. Повторяющееся поле — отказ: подпись сходится по одному значению, а код, который потом прочтёт сырую строку другим парсером, может взять другое (user=<подделка>&<настоящие данные>).
  • WebAppData — разобранные данные: authDate, queryId, startParam, user, chat, fields.
  • Laravel: валидатор связан в сервис-провайдере с maxbot.access_token (алиас maxbot.webapp), его можно получать через DI.
  • Тесты подписывают данные независимо от валидатора; покрытие новых классов 100 %. Документация — README и docs/README.md.

Код в продакшене у нас (Laravel-бэкенд мини-приложения в Telegram и MAX) с сентября 2026, здесь — оформленный под библиотеку.

Checks window.WebApp.initData by the bot token as dev.max.ru/docs/webapps/validation
describes, then its age, and returns the data parsed. A repeated field is refused.
Bound in the Laravel service provider with the configured token.
@BushlanovDev BushlanovDev self-assigned this Oct 28, 2026
@BushlanovDev

Copy link
Copy Markdown
Owner

Спасибо

@BushlanovDev
BushlanovDev merged commit a83a2a3 into BushlanovDev:master Oct 28, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants