Начало темыИсходник

Бот для сбора заявок с веб-формы в Telegram (Mini App + FastAPI)

keramickeramicНовичок·10.11.2026· 0 ответов 0 реакций

Классическая история: лендинг есть, а заявки теряются в почте, которую никто не читает. Я собрал связку «Mini App → FastAPI → топик в Telegram», и хочу рассказать не про то, как рисовать форму, а про то, где именно всё ломается на безопасности. Потому что форма — это пять минут, а вот не пустить в неё кого угодно — основная работа.

Первое и главное: клиенту доверять нельзя, вообще. В мини-приложении есть клиентская валидация, но она нужна только чтобы не гонять заведомо плохие заявки. Всё решается на сервере: подпись, лимиты, honeypot. И центральная часть — проверка подписи initData, потому что без неё любой может постучаться на /api/lead и притвориться кем угодно.

Механика ровно такая, как описывает Telegram. Собираешь строку из всех пар key=value кроме hash, отсортированных по ключу и склеенных через перенос строки. Ключом HMAC становится не токен напрямую, а HMAC_SHA256(key="WebAppData", msg=bot_token) — это ловушка, на которой спотыкаются, потому что интуиция подсказывает взять токен как key. Потом сверяешь hash, и сверять надо через hmac.compare_digest, а не через ==, иначе получишь timing-атаку на ровном месте. Плюс отдельно проверяю auth_date: истёкшую подпись отбиваю, иначе один раз утёкший initData останется валидным навсегда.

Проверить всё это можно без сети и без токена — TestClient в FastAPI. Вот реальный прогон, где я бью по эндпоинту разными способами:

Смотри на коды. Корректная подпись проходит, подделанная (я меняю последний символ) отбивается 401. Устаревшая на два часа — тоже 401, с честной причиной. Honeypot я заполняю как бот — сервер отвечает 200, но заявку не пишет, боту нет смысла знать, что его раскусили. Телефон из трёх цифр отсекается ещё до записи, на уровне pydantic, 422. И антифлуд: пять заявок с одного IP проходят, шестая и дальше — 429 до конца минуты.

Про honeypot отдельно, потому что приём старый, а работает. В форме есть поле, которое человек не видит (унесено за экран), но бот заполняет всё подряд. Заполнено — притворяемся, что приняли, и молча не пишем. Настоящую капчу это не заменяет, но режет самый тупой спам бесплатно.

Теперь оговорки. За прокси обязательно читай X-Forwarded-For, иначе антифлуд посчитает весь трафик одним IP — адресом балансировщика — и забанит всех разом. Уведомление в Telegram я специально не считаю критичным: если send_message упал из-за лимитов или сети, заявка уже в базе, потеряется только сообщение в чат, и это правильно. И HTTPS обязателен: Telegram просто не откроет мини-приложение по http, для отладки ставь ngrok.

В архиве: webapp/index.html, app.py, initdata.py, db.py, Dockerfile и docker-compose с .env.example, скрипт прогона и README. Поднимается на 1 ГБ VPS, всё воспроизводится локально.

import antigravity

Исходники
lead-miniapp.zipЗарегистрируйтесь и поставьте реакцию на сообщение — исходник откроется.15 КБ

Комментарии

0
Пока нет комментариев. Войдите, чтобы ответить первым.