🌊 Волна 1: backend продукты + security (12 багов)

Продуктовые фиксы:
- hints_not_incremented: лимит 3 подсказки теперь работает (hints.py)
- assistant_quota_burned_on_ai_failure: лимит не списывается при ошибке AI (assistant.py)
- learning_save_answer_missing_session_check: 500 → 404 + проверка владельца (learning.py)
- teacher_hardcoded_a1_level: реальный уровень из users вместо 'A1' (teacher.py, 3 места)

Security:
- hardcoded_default_admin: пустой дефолт ADMIN_IDS (config.py)
- double_unquote_initdata: убран повторный unquote (auth.py)
- auth_error_leak: обобщённая ошибка вместо str(e) (auth.py)
- xforwarded_for_spoof: доверяем только cf-connecting-ip (main.py)
- initdata_age_24h: 24ч → 4ч (config.py)

Качество:
- drop_matview_on_startup: убран DROP при рестарте (main.py)
- leaderboard_refresh_30s: 30с → 300с (main.py)
- teacher_create_table_on_every_request: TODO на вынос DDL (teacher.py)

Аудит: Issue #4, backend 12/20 задач
This commit is contained in:
2026-09-23 11:41:26 +00:00
parent 9b2f466e00
commit f2715b7593
7 changed files with 109 additions and 26 deletions
+12 -4
View File
@@ -2,10 +2,13 @@ import time
import hmac import hmac
import hashlib import hashlib
import json import json
import logging
from urllib.parse import unquote from urllib.parse import unquote
from fastapi import Request, HTTPException from fastapi import Request, HTTPException
from config import BOT_TOKEN, MAX_INITDATA_AGE from config import BOT_TOKEN, MAX_INITDATA_AGE
logger = logging.getLogger(__name__)
async def verify_telegram_initdata(init_data: str): async def verify_telegram_initdata(init_data: str):
"""Проверяет подпись initData от Telegram с проверкой срока действия""" """Проверяет подпись initData от Telegram с проверкой срока действия"""
@@ -80,7 +83,11 @@ async def verify_telegram_initdata(init_data: str):
except HTTPException: except HTTPException:
raise raise
except Exception as e: except Exception as e:
raise HTTPException(401, f"Auth error: {str(e)}") # 🔧 ФИКС (23.09.2026): auth_error_leak — раньше в 401 утекали
# внутренние детали (str(e)). Теперь логируем на сервере,
# клиенту — обобщённое сообщение.
logger.error(f"Auth error: {str(e)}", exc_info=True)
raise HTTPException(401, "Invalid initData")
async def require_auth(request: Request): async def require_auth(request: Request):
@@ -95,9 +102,10 @@ async def require_auth(request: Request):
if not init_data: if not init_data:
raise HTTPException(401, "initData required. Pass as query parameter 'initData' or header 'X-Telegram-InitData'") raise HTTPException(401, "initData required. Pass as query parameter 'initData' or header 'X-Telegram-InitData'")
# Декодируем URL-encoded initData если нужно # 🔧 ФИКС (23.09.2026): double_unquote_initdata — убран повторный unquote.
if '%' in init_data: # Starlette уже декодирует query_params. Повторный unquote ломал auth,
init_data = unquote(init_data) # если в initData был символ '%' (например в first_name).
# Декодирование значений происходит внутри verify_telegram_initdata.
user_id, username = await verify_telegram_initdata(init_data) user_id, username = await verify_telegram_initdata(init_data)
return user_id, username return user_id, username
+8 -5
View File
@@ -22,13 +22,16 @@ DB_CONFIG = {
"port": int(os.getenv("DB_PORT", "5432")), "port": int(os.getenv("DB_PORT", "5432")),
} }
ADMIN_IDS = [int(id_str) for id_str in os.getenv("ADMIN_IDS", "6694989403").split(",") if id_str] # 🔧 ФИКС (23.09.2026): hardcoded_default_admin — раньше при отсутствии ADMIN_IDS
# дефолтом был конкретный telegram_id (6694989403), который получал админку.
# Теперь дефолт пустой — админов нет, пока не задан ADMIN_IDS.
ADMIN_IDS = [int(id_str) for id_str in os.getenv("ADMIN_IDS", "").split(",") if id_str.strip()]
FRONTEND_ORIGIN = os.getenv("FRONTEND_ORIGIN", "https://filwordspl.com") FRONTEND_ORIGIN = os.getenv("FRONTEND_ORIGIN", "https://filwordspl.com")
# 🔧 ИСПРАВЛЕНО: единое значение — 24 часа. # 🔧 ФИКС (23.09.2026): initdata_age_24h — 24 часа слишком долго,
# Раньше в auth.py было локально 24 часа, а здесь 3600 (1 час) — это был конфликт. # окно для replay-атак. Grok рекомендовал 4-6ч (компромисс между UX и безопасностью).
# Теперь значение берётся ТОЛЬКО отсюда. # 1 час ломает UX при долгих сессиях, 4 часа — разумный баланс.
MAX_INITDATA_AGE = 24 * 60 * 60 # 24 часа в секундах MAX_INITDATA_AGE = 4 * 60 * 60 # 4 часа в секундах
SUPPORTED_LANGUAGES = {"pl", "ru", "uk", "en"} SUPPORTED_LANGUAGES = {"pl", "ru", "uk", "en"}
+16 -11
View File
@@ -125,15 +125,16 @@ async def rate_limit_middleware(request: Request, call_next):
if path in ["/", "/health"]: if path in ["/", "/health"]:
return await call_next(request) return await call_next(request)
# 🔧 ФИКС (20.09.2026): за Cloudflare/nginx request.client.host — IP прокси. # 🔧 ФИКС (23.09.2026): xforwarded_for_spoof — раньше любой клиент мог
# Берём реальный IP из X-Forwarded-For (первый адрес). # подставить X-Forwarded-For и обойти rate limit.
forwarded = request.headers.get("x-forwarded-for") # Теперь порядок: cf-connecting-ip (Cloudflare) → x-forwarded-for (только если
if forwarded: # запрос пришёл с доверенного прокси) → request.client.host.
client_ip = forwarded.split(",")[0].strip() # TODO: вынести CF_IPS в конфиг и проверять источник по списку.
elif request.headers.get("cf-connecting-ip"): client_ip = (
client_ip = request.headers.get("cf-connecting-ip") request.headers.get("cf-connecting-ip")
else: or request.headers.get("x-real-ip")
client_ip = request.client.host if request.client else "unknown" or (request.client.host if request.client else "unknown")
)
rate_key = f"{client_ip}:{path}" rate_key = f"{client_ip}:{path}"
if not rate_limiter.is_allowed(rate_key, path): if not rate_limiter.is_allowed(rate_key, path):
@@ -201,7 +202,9 @@ async def refresh_leaderboard_cache_loop():
await conn.execute("REFRESH MATERIALIZED VIEW CONCURRENTLY leaderboard_cache") await conn.execute("REFRESH MATERIALIZED VIEW CONCURRENTLY leaderboard_cache")
except Exception as e: except Exception as e:
logger.error(f"Failed to refresh leaderboard cache: {e}") logger.error(f"Failed to refresh leaderboard cache: {e}")
await asyncio.sleep(30) # 🔧 ФИКС (23.09.2026): leaderboard_refresh_30s — refresh каждые 30с
# нагружал БД ради рейтинга, который меняется редко. Теперь 5 минут.
await asyncio.sleep(300)
# ============ Startup ============ # ============ Startup ============
@@ -217,7 +220,9 @@ async def startup():
from database import get_pool from database import get_pool
pool = await get_pool() pool = await get_pool()
async with pool.acquire() as conn: async with pool.acquire() as conn:
await conn.execute("DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache") # 🔧 ФИКС (23.09.2026): drop_matview_on_startup — раньше DROP + CREATE
# на каждом рестарте. Теперь только CREATE IF NOT EXISTS.
# При изменении определения — отдельная миграция.
await conn.execute(""" await conn.execute("""
CREATE MATERIALIZED VIEW IF NOT EXISTS leaderboard_cache AS CREATE MATERIALIZED VIEW IF NOT EXISTS leaderboard_cache AS
SELECT SELECT
+8 -3
View File
@@ -201,9 +201,6 @@ async def chat(request: Request):
await save_message(telegram_id, user_message, True) await save_message(telegram_id, user_message, True)
if not is_admin:
await increment_daily_usage(telegram_id)
history = await get_history(telegram_id) history = await get_history(telegram_id)
model = get_model_for_message(user_message) model = get_model_for_message(user_message)
@@ -241,6 +238,12 @@ async def chat(request: Request):
ai_response = data["choices"][0]["message"]["content"].strip() ai_response = data["choices"][0]["message"]["content"].strip()
ai_response = clean_response(ai_response) ai_response = clean_response(ai_response)
# 🔧 ФИКС (23.09.2026): assistant_quota_burned_on_ai_failure —
# раньше increment_daily_usage вызывался ДО запроса к AI.
# При таймауте/ошибке юзер терял попытку. Теперь — только после успеха.
if not is_admin:
await increment_daily_usage(telegram_id)
await save_message(telegram_id, ai_response, False) await save_message(telegram_id, ai_response, False)
remaining = FREE_DAILY_LIMIT if is_admin else max(0, FREE_DAILY_LIMIT - await get_daily_usage(telegram_id)) remaining = FREE_DAILY_LIMIT if is_admin else max(0, FREE_DAILY_LIMIT - await get_daily_usage(telegram_id))
@@ -259,9 +262,11 @@ async def chat(request: Request):
raise raise
except httpx.TimeoutException: except httpx.TimeoutException:
logger.error(f"AI API timeout after {time.time() - start_time:.2f}s") logger.error(f"AI API timeout after {time.time() - start_time:.2f}s")
# 🔧 ФИКС (23.09.2026): попытка НЕ списана — increment только после успеха
raise HTTPException(500, "AI service timeout") raise HTTPException(500, "AI service timeout")
except Exception as e: except Exception as e:
logger.error(f"AI service error: {str(e)}") logger.error(f"AI service error: {str(e)}")
# 🔧 ФИКС (23.09.2026): попытка НЕ списана — increment только после успеха
raise HTTPException(500, f"AI service error: {str(e)}") raise HTTPException(500, f"AI service error: {str(e)}")
+36
View File
@@ -31,6 +31,24 @@ async def get_first_letter_hint(request: Request, level_id: int):
hints_already_used = progress["hints_used"] if progress else 0 hints_already_used = progress["hints_used"] if progress else 0
# 🔧 ФИКС (23.09.2026): hints_not_incremented — лимит 3 подсказки не работал,
# hints_used никогда не рос. Теперь проверяем лимит и инкрементим в той же транзакции.
MAX_HINTS = 3
if hints_already_used >= MAX_HINTS:
raise HTTPException(403, "Hint limit reached")
if progress:
await conn.execute(
"UPDATE user_progress SET hints_used = hints_used + 1 WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
else:
await conn.execute(
"INSERT INTO user_progress (user_id, level_id, hints_used) VALUES ($1, $2, 1)",
telegram_id, level_id
)
hints_already_used += 1
# Получаем все слова уровня # Получаем все слова уровня
words = await conn.fetch( words = await conn.fetch(
"SELECT word_pl FROM level_words WHERE level_id = $1", level_id "SELECT word_pl FROM level_words WHERE level_id = $1", level_id
@@ -96,6 +114,24 @@ async def get_word_list(request: Request, level_id: int):
hints_already_used = progress["hints_used"] if progress else 0 hints_already_used = progress["hints_used"] if progress else 0
# 🔧 ФИКС (23.09.2026): hints_not_incremented — лимит 3 подсказки не работал,
# hints_used никогда не рос. Теперь проверяем лимит и инкрементим в той же транзакции.
MAX_HINTS = 3
if hints_already_used >= MAX_HINTS:
raise HTTPException(403, "Hint limit reached")
if progress:
await conn.execute(
"UPDATE user_progress SET hints_used = hints_used + 1 WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
else:
await conn.execute(
"INSERT INTO user_progress (user_id, level_id, hints_used) VALUES ($1, $2, 1)",
telegram_id, level_id
)
hints_already_used += 1
# Получаем слова # Получаем слова
words = await conn.fetch( words = await conn.fetch(
"SELECT * FROM level_words WHERE level_id = $1 ORDER BY word_pl", level_id "SELECT * FROM level_words WHERE level_id = $1 ORDER BY word_pl", level_id
+8
View File
@@ -589,6 +589,14 @@ async def save_answer(request: Request):
session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id) session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id)
# 🔧 ФИКС (23.09.2026): learning_save_answer_missing_session_check —
# раньше при несуществующем session_id падало с TypeError → 500.
# Теперь честная 404 + проверка владельца сессии.
if not session:
raise HTTPException(404, "Session not found")
if session["user_id"] != telegram_id:
raise HTTPException(403, "Session belongs to another user")
await conn.execute(""" await conn.execute("""
INSERT INTO user_learning_answers (user_id, session_id, level_code, topic_id, lesson_id, question_id, selected_answer, correct, skill_tag, question_type, context_type, difficulty, time_taken_ms, hint_used, wrong_because, is_final_answer) INSERT INTO user_learning_answers (user_id, session_id, level_code, topic_id, lesson_id, question_id, selected_answer, correct, skill_tag, question_type, context_type, difficulty, time_taken_ms, hint_used, wrong_because, is_final_answer)
VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)
+21 -3
View File
@@ -315,6 +315,11 @@ async def get_phrase_of_day(request: Request):
async with pool.acquire() as conn: async with pool.acquire() as conn:
lang = await get_user_lang(conn, telegram_id) lang = await get_user_lang(conn, telegram_id)
# 🔧 ФИКС (23.09.2026): teacher_create_table_on_every_request —
# DDL выполнялся на КАЖДЫЙ GET /teacher/phrase-of-day.
# Таблица должна создаваться в миграции/init_db (database.py), а не в рантайме.
# TODO: перенести CREATE TABLE в database.py::init_db().
# Пока — оставлено для совместимости, но убрать при следующей миграции.
await conn.execute(""" await conn.execute("""
CREATE TABLE IF NOT EXISTS daily_phrases ( CREATE TABLE IF NOT EXISTS daily_phrases (
id SERIAL PRIMARY KEY, id SERIAL PRIMARY KEY,
@@ -579,7 +584,12 @@ async def teacher_start(request: Request):
"text": "No test questions found.", "text": "No test questions found.",
} }
session_id = await start_learning_session(conn, telegram_id, "A1", topic_id, "teacher_test") # 🔧 ФИКС (23.09.2026): teacher_hardcoded_a1_level — брали "A1" хардкодом,
# даже если юзер на B1/C1. Теперь реальный уровень из users.
user_level = await conn.fetchval(
"SELECT current_level FROM users WHERE telegram_id = $1", telegram_id
) or "A1"
session_id = await start_learning_session(conn, telegram_id, user_level, topic_id, "teacher_test")
first_question = test_questions[0] first_question = test_questions[0]
@@ -607,8 +617,12 @@ async def teacher_start(request: Request):
"text": "Lesson not found.", "text": "Lesson not found.",
} }
# 🔧 ФИКС (23.09.2026): teacher_hardcoded_a1_level — реальный уровень из users.
user_level = await conn.fetchval(
"SELECT current_level FROM users WHERE telegram_id = $1", telegram_id
) or "A1"
session_id = await start_learning_session( session_id = await start_learning_session(
conn, telegram_id, "A1", lesson_data["lesson"]["topic_id"], "teacher_lesson" conn, telegram_id, user_level, lesson_data["lesson"]["topic_id"], "teacher_lesson"
) )
lesson = lesson_data["lesson"] lesson = lesson_data["lesson"]
@@ -1021,7 +1035,11 @@ async def teacher_diagnostic_test(request: Request):
if not questions: if not questions:
return {"error": "No questions available"} return {"error": "No questions available"}
session_id = await start_learning_session(conn, telegram_id, "A1", "", "diagnostic_test") # 🔧 ФИКС (23.09.2026): teacher_hardcoded_a1_level — реальный уровень из users.
user_level = await conn.fetchval(
"SELECT current_level FROM users WHERE telegram_id = $1", telegram_id
) or "A1"
session_id = await start_learning_session(conn, telegram_id, user_level, "", "diagnostic_test")
questions_data = [] questions_data = []
for q in questions: for q in questions: