Перейти к содержимому

Проверка подписи ​

Передавайте в validate исходную строку и токен бота MAX. Серверный пакет декодирует параметры, исключает hash, сортирует остальные ключи и проверяет подпись через HMAC-SHA256. Только после успешной проверки подписи он интерпретирует вложенные данные пользователя и чата. Алгоритм MAX

validate и safeValidate ​

validate возвращает InitData или отклоняет Promise. safeValidate удобен для обычного разбора запроса. При ошибке входных данных он возвращает { ok: false, error }. При успешной проверке возвращает { ok: true, data }. Ошибки конфигурации и среды выполнения отклоняют Promise и в этом варианте.

ts
import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';

import { safeValidate } from '@mwa.js/init-data';

const MAX_BODY_BYTES = 64 * 1024;

function json(response: ServerResponse, status: number, body: object) {
  response.writeHead(status, {
    'content-type': 'application/json; charset=utf-8',
    'cache-control': 'no-store',
  });
  response.end(JSON.stringify(body));
}

async function readBody(request: IncomingMessage): Promise<Buffer | undefined> {
  let bytes = 0;
  const chunks: Buffer[] = [];
  for await (const chunk of request.iterator({ destroyOnReturn: false }) as AsyncIterable<Buffer>) {
    bytes += chunk.length;
    if (bytes > MAX_BODY_BYTES) {
      request.resume();
      return undefined;
    }
    chunks.push(chunk);
  }
  return Buffer.concat(chunks, bytes);
}

export function createValidationServer(botToken: string) {
  if (!botToken.trim()) throw new Error('Set MAX_BOT_TOKEN before starting the server.');

  async function handle(request: IncomingMessage, response: ServerResponse) {
    if (request.url !== '/api/validate') {
      request.resume();
      return json(response, 404, { error: 'not_found' });
    }
    if (request.method !== 'POST') {
      request.resume();
      response.setHeader('allow', 'POST');
      return json(response, 405, { error: 'method_not_allowed' });
    }
    const contentType = request.headers['content-type']?.split(';', 1)[0]?.trim().toLowerCase();
    if (contentType !== 'text/plain') {
      request.resume();
      return json(response, 415, { error: 'unsupported_media_type' });
    }

    const body = await readBody(request);
    if (!body) return json(response, 413, { error: 'body_too_large' });

    let raw: string;
    try {
      raw = new TextDecoder('utf-8', { fatal: true }).decode(body);
    } catch {
      return json(response, 400, { error: 'invalid_encoding' });
    }
    const result = await safeValidate(raw, botToken);
    if (!result.ok || !result.data.user) {
      return json(response, 401, { error: 'invalid_init_data' });
    }
    json(response, 200, { userId: result.data.user.id });
  }

  return createServer((request, response) => {
    void handle(request, response).catch(() => {
      if (!response.headersSent && !response.destroyed) {
        json(response, 500, { error: 'internal_error' });
      }
    });
  });
}

Срок действия ​

expiresIn задаёт максимально допустимый возраст в секундах. По умолчанию применяется один час. Для своего сценария можно указать другое целое неотрицательное значение. expiresIn: 0 отключает проверку возраста, а проверка подписи остаётся включённой.

ts
import { validate } from '@mwa.js/init-data';

export function validateRecentLaunch(raw: string, botToken: string) {
  return validate(raw, botToken, { expiresIn: 300 });
}

Проверьте протокол целиком по руководству авторизации. Для диагностики используйте коды ошибок.