🔐 Admin auth + Lectures backend

Новое:
- routers/admin_auth.py — JWT-логин для админки
- auth.py — двухрежимная авторизация (X-Admin-Token + Telegram)
- config.py — ADMIN_LOGIN, ADMIN_PASSWORD_HASH, ADMIN_JWT_SECRET,
              FRONTEND_ORIGINS (admin.filwordspl.com), ADMIN_TOKEN_USER_ID
- main.py — CORS для admin-домена, X-Admin-Token в allow_headers
- routers/lectures.py — 6 эндпоинтов для лекций (PDF/HTML)
- database.py — таблица lectures
- smoke_test_report.md — отчёт робота
This commit is contained in:
2026-09-27 07:54:32 +00:00
parent f7859783d3
commit 453db5b91c
5 changed files with 232 additions and 57 deletions
+46 -40
View File
@@ -19,116 +19,122 @@ async def verify_telegram_initdata(init_data: str):
if '=' in chunk:
key, value = chunk.split('=', 1)
data[key] = unquote(value)
# Извлекаем hash
received_hash = data.pop('hash', '')
if not received_hash:
raise HTTPException(401, "Hash not found in initData")
# Проверяем auth_date (не старше MAX_INITDATA_AGE из config)
auth_date_str = data.get('auth_date', '0')
try:
auth_date = int(auth_date_str)
current_time = int(time.time())
if current_time - auth_date > MAX_INITDATA_AGE:
raise HTTPException(401, "initData expired")
if auth_date > current_time + 60:
raise HTTPException(401, "initData from future")
except ValueError:
raise HTTPException(401, "Invalid auth_date")
# Сортируем ключи и создаем строку для проверки
check_arr = []
for key in sorted(data.keys()):
check_arr.append(f"{key}={data[key]}")
check_string = '\n'.join(check_arr)
# Создаем секретный ключ
secret_key = hmac.new(
'WebAppData'.encode(),
BOT_TOKEN.encode(),
'WebAppData'.encode(),
BOT_TOKEN.encode(),
hashlib.sha256
).digest()
# Вычисляем hash
calculated_hash = hmac.new(
secret_key,
check_string.encode(),
secret_key,
check_string.encode(),
hashlib.sha256
).hexdigest()
if not hmac.compare_digest(calculated_hash, received_hash):
raise HTTPException(401, "Invalid initData signature")
# Извлекаем данные пользователя
user_data_str = data.get('user', '{}')
try:
user_data = json.loads(user_data_str)
except json.JSONDecodeError:
raise HTTPException(401, "Invalid user data JSON")
user_id = user_data.get('id')
username = user_data.get('username', '')
# 🔧 ФИКС (25.09.2026): unused_first_name — удалена мёртвая переменная.
if not user_id:
raise HTTPException(401, "User ID not found in initData")
return user_id, username
except HTTPException:
raise
except Exception as 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):
"""Извлекает и проверяет initData из запроса.
"""Извлекает и проверяет авторизацию из запроса.
🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — поддержка Authorization: tma <initData>.
Приоритет источников:
1. Authorization: tma <initData> — новый способ (фронт 23.09+)
2. X-Telegram-InitData — старый способ (фронт до 23.09)
3. query-параметр initData — fallback для deleteFeedPost
(осознанное исключение из-за
Cloudflare preflight-кеша)
Два режима:
1. X-Admin-Token: <jwt> — админка через браузер (26.09.2026)
2. Authorization: tma <initData> — Telegram Mini App
Zero-downtime: старые и новые клиенты работают одновременно.
Приоритет:
1. X-Admin-Token — если есть, проверяем JWT.
2. Authorization: tma <initData> — основной для Mini App.
3. X-Telegram-InitData — старый способ.
4. query-параметр initData — fallback для deleteFeedPost.
"""
# ============ Режим 1: админ-токен ============
admin_token = request.headers.get('X-Admin-Token', '').strip()
if admin_token:
try:
from routers.admin_auth import verify_jwt
from config import ADMIN_TOKEN_USER_ID
payload = verify_jwt(admin_token)
# Возвращаем специальный ID для admin-токена
return ADMIN_TOKEN_USER_ID, payload.get('login', 'admin')
except ValueError as e:
logger.warning(f"Admin token invalid: {e}")
raise HTTPException(401, "Invalid admin token")
# ============ Режим 2: Telegram initData ============
init_data = ''
# 1. Authorization: tma <initData> (новый способ)
# 2.1. Authorization: tma <initData>
auth_header = request.headers.get('Authorization', '')
if auth_header.startswith('tma '):
init_data = auth_header[4:].strip()
# 2. X-Telegram-InitData (старый способ)
# 2.2. X-Telegram-InitData (старый способ)
if not init_data:
init_data = request.headers.get('X-Telegram-InitData', '')
# 3. Query-параметр (fallback, нужен для deleteFeedPost)
# 2.3. Query-параметр (fallback, нужен для deleteFeedPost)
if not init_data:
init_data = request.query_params.get('initData', '')
if not init_data:
raise HTTPException(
401,
"initData required. Pass as Authorization header 'tma <initData>' "
"or 'X-Telegram-InitData' or query parameter 'initData'"
"Authorization required. Pass 'X-Admin-Token' or "
"'Authorization: tma <initData>' or 'X-Telegram-InitData' "
"or query parameter 'initData'"
)
# 🔧 ФИКС (23.09.2026): double_unquote_initdata — убран повторный unquote.
# Starlette уже декодирует query_params. Повторный unquote ломал auth,
# если в initData был символ '%' (например в first_name).
# Декодирование значений происходит внутри verify_telegram_initdata.
user_id, username = await verify_telegram_initdata(init_data)
return user_id, username
+17 -2
View File
@@ -26,7 +26,16 @@ DB_CONFIG = {
# дефолтом был конкретный 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")
# Маркер для admin-токена (авторизация через браузер)
ADMIN_TOKEN_USER_ID = -1
if ADMIN_TOKEN_USER_ID not in ADMIN_IDS:
ADMIN_IDS.append(ADMIN_TOKEN_USER_ID)
# 🔧 ФИКС (26.09.2026): admin_cors — добавляем admin-домен для CORS
FRONTEND_ORIGINS = [
"https://filwordspl.com",
"https://admin.filwordspl.com",
]
# 🔧 ФИКС (23.09.2026): initdata_age_24h — 24 часа слишком долго,
# окно для replay-атак. Grok рекомендовал 4-6ч (компромисс между UX и безопасностью).
@@ -78,4 +87,10 @@ FEED_ALLOWED_IMAGE_TYPES = {
}
# Языки, на которые переводим feed-посты (используется в admin_feed translate)
FEED_TARGET_LANGUAGES = ["pl", "ru", "uk", "en"]
FEED_TARGET_LANGUAGES = ["pl", "ru", "uk", "en"]
# ============ ADMIN PANEL (26.09.2026) ============
# Логин/пароль для входа в админку через браузер.
ADMIN_LOGIN = os.getenv("ADMIN_LOGIN", "admin")
ADMIN_PASSWORD_HASH = os.getenv("ADMIN_PASSWORD_HASH", "")
ADMIN_JWT_SECRET = os.getenv("ADMIN_JWT_SECRET", "")
+7 -3
View File
@@ -11,10 +11,10 @@ from fastapi import FastAPI, Request, HTTPException
from fastapi.middleware.cors import CORSMiddleware
from fastapi.responses import JSONResponse
from fastapi.staticfiles import StaticFiles
from config import FRONTEND_ORIGIN, UPLOADS_DIR, CF_IPS
from config import FRONTEND_ORIGINS, UPLOADS_DIR, CF_IPS
from database import init_db
from routers import users, game, hints, leaderboard, sentences, achievements, wordquiz, bubblewords, pronunciation, assistant, learning, tts, typing, teacher, support, admin, feed, admin_content
from routers import lectures
from routers import lectures, admin_auth
from routers.sentences import init_sentences
from routers.achievements import init_achievements
from routers.learning_data import init_learning_data
@@ -323,9 +323,11 @@ async def rate_limit_middleware(request: Request, call_next):
# ============ CORS ============
# 🔧 ФИКС (26.09.2026): admin_cors — добавлен admin.filwordspl.com в origins.
# Также добавлен X-Admin-Token в allow_headers для админ-авторизации.
app.add_middleware(
CORSMiddleware,
allow_origins=[FRONTEND_ORIGIN],
allow_origins=FRONTEND_ORIGINS,
allow_credentials=False,
allow_methods=["GET", "POST", "PUT", "DELETE", "OPTIONS"],
# 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — добавлен Authorization в явный список.
@@ -335,6 +337,7 @@ app.add_middleware(
"Authorization",
"Content-Type",
"X-Telegram-InitData",
"X-Admin-Token",
],
)
@@ -361,6 +364,7 @@ app.include_router(admin.router)
app.include_router(feed.router)
app.include_router(admin_content.router)
app.include_router(lectures.router)
app.include_router(admin_auth.router)
# ============ Базовые эндпоинты ============
+124
View File
@@ -0,0 +1,124 @@
"""
Admin Auth Router — авторизация админки через логин/пароль.
Отдаёт JWT-токен. Токен используется для доступа к /admin/* эндпоинтам
через заголовок X-Admin-Token.
"""
import hashlib
import hmac
import json
import time
import base64
import logging
from fastapi import APIRouter, Request, HTTPException
from config import ADMIN_LOGIN, ADMIN_PASSWORD_HASH, ADMIN_JWT_SECRET
logger = logging.getLogger(__name__)
router = APIRouter(prefix="/admin", tags=["admin-auth"])
# Время жизни токена — 24 часа
TOKEN_TTL_SECONDS = 24 * 60 * 60
def _base64url_encode(data: bytes) -> str:
return base64.urlsafe_b64encode(data).rstrip(b"=").decode("ascii")
def _base64url_decode(data: str) -> bytes:
padding = "=" * (4 - len(data) % 4)
return base64.urlsafe_b64decode(data + padding)
def create_jwt(payload: dict) -> str:
"""Создаёт JWT-токен с HMAC-SHA256 подписью."""
header = {"alg": "HS256", "typ": "JWT"}
header_b64 = _base64url_encode(json.dumps(header, separators=(",", ":")).encode())
payload_b64 = _base64url_encode(json.dumps(payload, separators=(",", ":")).encode())
message = f"{header_b64}.{payload_b64}"
signature = hmac.new(
ADMIN_JWT_SECRET.encode(),
message.encode(),
hashlib.sha256,
).digest()
signature_b64 = _base64url_encode(signature)
return f"{message}.{signature_b64}"
def verify_jwt(token: str) -> dict:
"""Проверяет JWT-токен. Возвращает payload или бросает исключение."""
try:
parts = token.split(".")
if len(parts) != 3:
raise ValueError("Invalid token format")
header_b64, payload_b64, signature_b64 = parts
message = f"{header_b64}.{payload_b64}"
expected_signature = hmac.new(
ADMIN_JWT_SECRET.encode(),
message.encode(),
hashlib.sha256,
).digest()
actual_signature = _base64url_decode(signature_b64)
if not hmac.compare_digest(expected_signature, actual_signature):
raise ValueError("Invalid signature")
payload = json.loads(_base64url_decode(payload_b64))
# Проверяем срок действия
if payload.get("exp", 0) < time.time():
raise ValueError("Token expired")
return payload
except Exception as e:
raise ValueError(f"Invalid token: {e}")
@router.post("/login")
async def admin_login(request: Request):
"""
Логин админа. Принимает {login, password}, отдаёт JWT-токен.
"""
if not ADMIN_PASSWORD_HASH or not ADMIN_JWT_SECRET:
raise HTTPException(500, "Admin auth not configured")
body = await request.json()
login = (body.get("login") or "").strip()
password = body.get("password") or ""
if not login or not password:
raise HTTPException(400, "login and password required")
# Проверяем логин
if login != ADMIN_LOGIN:
logger.warning(f"Admin login failed: wrong login '{login}'")
raise HTTPException(401, "Invalid credentials")
# Проверяем пароль (sha256-хэш)
password_hash = hashlib.sha256(password.encode()).hexdigest()
if not hmac.compare_digest(password_hash, ADMIN_PASSWORD_HASH):
logger.warning(f"Admin login failed: wrong password for '{login}'")
raise HTTPException(401, "Invalid credentials")
# Создаём JWT
now = int(time.time())
payload = {
"sub": "admin",
"login": login,
"iat": now,
"exp": now + TOKEN_TTL_SECONDS,
}
token = create_jwt(payload)
logger.info(f"Admin login successful: {login}")
return {
"status": "ok",
"token": token,
"expires_in": TOKEN_TTL_SECONDS,
}
+38 -12
View File
@@ -1,7 +1,7 @@
# 🧪 Smoke-test отчёт (реальный юзер, реальная БД)
**Дата:** 2026-09-26 09:36 UTC
**Итого:** 53/53 сценариев прошли
**Дата:** 2026-09-26 09:54 UTC
**Итого:** 77/77 сценариев прошли
## ✅ Подтверждено рабочим
@@ -12,13 +12,13 @@
- **wordquiz_wrong_answer** (wordquiz) — status=200, mistakes 0→1
- **bubblewords_complete_flow** (bubblewords) — status=200, levels 0→1, score 0→100
- **sentences_check_wrong** (sentences) — status=200, score 0→0 (неверный)
- **typing_progress_flow** (typing) — status=200, sentence_id=4636, recorded=True
- **typing_progress_flow** (typing) — status=200, sentence_id=4704, recorded=True
- **users_set_language** (users) — status=200, lang pl→ru
- **achievements_track_login** (achievements) — status=200, logins 0→1
- **learning_levels_list** (learning) — status=200, уровней=6
- **learning_topics_list** (learning) — status=200, тем A1=15
- **learning_topic_detail** (learning) — status=200, topic_id=a1_greetings, уроков=10
- **learning_session_start** (learning) — status=200, session_id=358, в БД=True
- **learning_session_start** (learning) — status=200, session_id=368, в БД=True
- **learning_session_full_flow** (learning) — answer=True, recorded=True, complete=True, is_completed=True
- **learning_progress** (learning) — status=200, тем=27
- **learning_lesson_detail** (learning) — status=200, lesson=True, questions=True, examples=True
@@ -29,7 +29,7 @@
- **teacher_phrase_of_day** (teacher) — status=200, phrase=Codziennie rano biorę prysznic i piję ka
- **teacher_start_or_resume** (teacher) — status=200, type=lesson_explanation, session_recorded=True
- **teacher_resume_no_session** (teacher) — status=200, has_active_session=True
- **teacher_diagnostic_test** (teacher) — status=200, session_id=361, questions=15, type=diagnostic_test
- **teacher_diagnostic_test** (teacher) — status=200, session_id=371, questions=15, type=diagnostic_test
- **teacher_answer_flow** (teacher) — status=200, reaction=True, is_correct=True, recorded=True
- **teacher_history_save_load** (teacher) — save=True, load=True, messages_match=True
- **teacher_history_clear** (teacher) — status=200, remaining=0
@@ -39,7 +39,7 @@
- **assistant_stats_personal** (assistant) — status=200, level=A1, score=240
- **assistant_stats_admin_forbidden** (assistant) — status=403 (ожидали 403 — тестовый юзер не админ)
- **support_user_tickets** (support) — status=200, тикетов=0
- **support_send** (support) — status=200, ticket_id=6, ticket_db=True, msg_db=True
- **support_send** (support) — status=200, ticket_id=8, ticket_db=True, msg_db=True
- **support_unread_count** (support) — status=200, unread_count=0
- **admin_dashboard_forbidden** (admin) — status=403 (ожидали 403 — тестовый юзер не админ)
- **admin_sentry_errors_forbidden** (admin) — status=403 (ожидали 403 — тестовый юзер не админ)
@@ -58,22 +58,48 @@
- **hints_remaining** (hints) — status=200, used=2/3, remaining=1
- **game_progress** (game) — status=200, last=1, score=240
- **game_check_word** (game) — status=200, found=False (координаты произвольные)
- **wordquiz_next** (wordquiz) — status=200, correct=True, options=3, diff=easy
- **wordquiz_progress** (wordquiz) — status=200, words=1, score=50
- **bubblewords_next** (bubblewords) — status=200, words=3, bubbles=9, level=2
- **bubblewords_progress** (bubblewords) — status=200, levels=1, score=100
- **sentences_next** (sentences) — status=200, id=4542, words=4
- **sentences_stats** (sentences) — status=200, total=200, completed=0, percent=0.0
- **sentences_hint** (sentences) — first=200, recorded=True, second=403 (ожидали 403)
- **typing_next** (typing) — status=200, sentence_id=4701
- **typing_hint** (typing) — first=200, recorded=True, second=403 (ожидали 403)
- **typing_progress** (typing) — status=200, 1/200, remaining=199
- **achievements_all** (achievements) — status=200, всего=56
- **assistant_history_clear** (assistant) — status=200, remaining=0
- **admin_content_summary** (admin_content) — status=200, уровней=6
- **admin_content_word_levels** (admin_content) — status=200, уровней=6
- **admin_content_word_detail** (admin_content) — status=200, word_id=36807, word_pl=eksplodować
- **admin_content_texts_levels** (admin_content) — status=200, уровней=6
- **admin_content_lessons_levels** (admin_content) — status=200, уровней=6
- **admin_content_lesson_topics** (admin_content) — status=200, тем A1=15
- **admin_content_lesson_detail** (admin_content) — status=200, lesson=True, examples=3, questions=3
- **admin_content_wrong_because** (admin_content) — status=200, записей=7
- **admin_feed_section_news** (admin_feed) — status=200, постов=0
- **admin_feed_delete_not_found** (admin_feed) — status=404 (ожидали 404)
- **admin_feed_upload_requires_post_id** (admin_feed) — status=422 (ожидали 422)
- **admin_feed_forbidden_for_user** (admin_feed) — status=403 (ожидали 403 — юзер не админ)
## 📊 По секциям
- **achievements**: 9/9
- **achievements**: 10/10
- **admin**: 2/2
- **assistant**: 4/4
- **bubblewords**: 1/1
- **admin_content**: 8/8
- **admin_feed**: 4/4
- **assistant**: 5/5
- **bubblewords**: 3/3
- **feed**: 1/1
- **game**: 3/3
- **hints**: 3/3
- **leaderboard**: 1/1
- **learning**: 10/10
- **pronunciation**: 1/1
- **sentences**: 1/1
- **sentences**: 4/4
- **support**: 3/3
- **teacher**: 8/8
- **typing**: 1/1
- **typing**: 4/4
- **users**: 3/3
- **wordquiz**: 2/2
- **wordquiz**: 4/4