MAX Bridge: initDataUnsafe хранит hash, но не для проверки

Один раздел, пять методов, два — про одни данные

В документации MAX Bridge (dev.max.ru) раздел «Работа с данными инициализации» открывает список функциональности библиотеки. Документация перечисляет сразу пять методов одним списком:

Три из пяти — platform, version и deviceName — сообщают о платформе, версии приложения и устройстве, с которого запущено мини-приложение. Оставшиеся два, initData и initDataUnsafe, — про сами стартовые данные: кто открыл мини-приложение, в каком чате и с каким параметром запуска.

Строка для сервера и объект без права на проверку

Первый метод возвращает данные в виде закодированной строки:

Документация уточняет назначение этой строки — закодированные в UTF-8 данные предназначены именно для проверки на сервере:

Второй метод отдаёт те же данные в удобном виде — готовым JSON-объектом:

Сразу под описанием — предупреждение, из-за которого в названии метода и стоит слово Unsafe:

Удобный для чтения объект годится, чтобы быстро подставить имя пользователя в интерфейс, но не годится, чтобы на его основании принимать решения, которые требуют уверенности в подлинности данных.

Hash есть в обоих — использовать можно только один

Оба метода описывает один и тот же интерфейс InitData, и в нём есть поле hash. Документация в таблице свойств объясняет его назначение так:

Формулировка относится к полю в целом, а не отдельно к строке и не отдельно к объекту, — но именно объект initDataUnsafe парой абзацев выше прямо помечен как непригодный для валидации. Получается, что hash физически присутствует и в initData, и в initDataUnsafe, но в разделе нет ни слова о том, можно ли проверять достоверность по значению hash, если оно взято из initDataUnsafe, а не из исходной строки initData. Единственная явная инструкция документации — использовать для проверки именно строку.

Что ещё лежит в стартовых данных

Кроме hash, в объекте InitData документация перечисляет ещё несколько полей. У поля auth_date указан не только тип, но и рекомендация по времени жизни:

При этом тип поля в документации — просто number: секунды это unix-времени или миллисекунды, раздел не уточняет. Ещё одно поле — необязательное и не про самого пользователя:

Рядом в таблице — идентификатор сессии:

Объект user несёт имя, фамилию, никнейм, код языка интерфейса и ссылку на фото профиля. Объект chat — идентификатор чата и один из трёх типов:

То есть уже на старте мини-приложение знает не только кто его открыл, но и в каком именно типе переписки — личном диалоге, групповом чате или канале.

Частые вопросы