Package io.r03el.tma.security.utils

Class TelegramAuth

java.lang.Object

io.r03el.tma.security.utils.TelegramAuth

public final class TelegramAuth
extends Object

Method Summary

Modifier and Type	Method	Description
static boolean	isValid(String telegramInitData, String botToken)	Validates the Telegram Mini App initData string using HmacUtils.
static TelegramUserDetails	parseUserData(String initData)	Parses user data from a VALID initData string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

isValid

public static boolean isValid(String telegramInitData,
 String botToken)

Validates the Telegram Mini App initData string using HmacUtils.

Parameters:

telegramInitData - The raw initData string from Telegram.

botToken - The Telegram Bot Token.

Returns:

true if the data is valid, false otherwise. Note: This implementation catches internal exceptions and logs them, returning false on error.

parseUserData

public static TelegramUserDetails parseUserData(String initData)

Parses user data from a VALID initData string. WARNING: Call this ONLY after validating the string with isValid! Requires a JSON library (like Jackson) on the classpath for proper parsing. Returns null if parsing fails or user data is not found.

Parameters:

initData - The validated initData string.

Returns:

TelegramUserDetails object or null.