🔐 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
+29 -23
View File
@@ -73,7 +73,6 @@ async def verify_telegram_initdata(init_data: str):
user_id = user_data.get('id') user_id = user_data.get('id')
username = user_data.get('username', '') username = user_data.get('username', '')
# 🔧 ФИКС (25.09.2026): unused_first_name — удалена мёртвая переменная.
if not user_id: if not user_id:
raise HTTPException(401, "User ID not found in initData") raise HTTPException(401, "User ID not found in initData")
@@ -83,52 +82,59 @@ async def verify_telegram_initdata(init_data: str):
except HTTPException: except HTTPException:
raise raise
except Exception as e: except Exception as e:
# 🔧 ФИКС (23.09.2026): auth_error_leak — раньше в 401 утекали
# внутренние детали (str(e)). Теперь логируем на сервере,
# клиенту — обобщённое сообщение.
logger.error(f"Auth error: {str(e)}", exc_info=True) logger.error(f"Auth error: {str(e)}", exc_info=True)
raise HTTPException(401, "Invalid initData") raise HTTPException(401, "Invalid initData")
async def require_auth(request: Request): async def require_auth(request: Request):
"""Извлекает и проверяет initData из запроса. """Извлекает и проверяет авторизацию из запроса.
🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — поддержка Authorization: tma <initData>. Два режима:
Приоритет источников: 1. X-Admin-Token: <jwt> — админка через браузер (26.09.2026)
1. Authorization: tma <initData> — новый способ (фронт 23.09+) 2. Authorization: tma <initData> — Telegram Mini App
2. X-Telegram-InitData — старый способ (фронт до 23.09)
3. query-параметр initData — fallback для deleteFeedPost
(осознанное исключение из-за
Cloudflare preflight-кеша)
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 = '' init_data = ''
# 1. Authorization: tma <initData> (новый способ) # 2.1. Authorization: tma <initData>
auth_header = request.headers.get('Authorization', '') auth_header = request.headers.get('Authorization', '')
if auth_header.startswith('tma '): if auth_header.startswith('tma '):
init_data = auth_header[4:].strip() init_data = auth_header[4:].strip()
# 2. X-Telegram-InitData (старый способ) # 2.2. X-Telegram-InitData (старый способ)
if not init_data: if not init_data:
init_data = request.headers.get('X-Telegram-InitData', '') init_data = request.headers.get('X-Telegram-InitData', '')
# 3. Query-параметр (fallback, нужен для deleteFeedPost) # 2.3. Query-параметр (fallback, нужен для deleteFeedPost)
if not init_data: if not init_data:
init_data = request.query_params.get('initData', '') init_data = request.query_params.get('initData', '')
if not init_data: if not init_data:
raise HTTPException( raise HTTPException(
401, 401,
"initData required. Pass as Authorization header 'tma <initData>' " "Authorization required. Pass 'X-Admin-Token' or "
"or 'X-Telegram-InitData' or query parameter 'initData'" "'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) user_id, username = await verify_telegram_initdata(init_data)
return user_id, username return user_id, username
+16 -1
View File
@@ -26,7 +26,16 @@ DB_CONFIG = {
# дефолтом был конкретный telegram_id (6694989403), который получал админку. # дефолтом был конкретный telegram_id (6694989403), который получал админку.
# Теперь дефолт пустой — админов нет, пока не задан ADMIN_IDS. # Теперь дефолт пустой — админов нет, пока не задан ADMIN_IDS.
ADMIN_IDS = [int(id_str) for id_str in os.getenv("ADMIN_IDS", "").split(",") if id_str.strip()] 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 часа слишком долго, # 🔧 ФИКС (23.09.2026): initdata_age_24h — 24 часа слишком долго,
# окно для replay-атак. Grok рекомендовал 4-6ч (компромисс между UX и безопасностью). # окно для replay-атак. Grok рекомендовал 4-6ч (компромисс между UX и безопасностью).
@@ -79,3 +88,9 @@ FEED_ALLOWED_IMAGE_TYPES = {
# Языки, на которые переводим feed-посты (используется в admin_feed translate) # Языки, на которые переводим 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.middleware.cors import CORSMiddleware
from fastapi.responses import JSONResponse from fastapi.responses import JSONResponse
from fastapi.staticfiles import StaticFiles 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 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 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.sentences import init_sentences
from routers.achievements import init_achievements from routers.achievements import init_achievements
from routers.learning_data import init_learning_data from routers.learning_data import init_learning_data
@@ -323,9 +323,11 @@ async def rate_limit_middleware(request: Request, call_next):
# ============ CORS ============ # ============ CORS ============
# 🔧 ФИКС (26.09.2026): admin_cors — добавлен admin.filwordspl.com в origins.
# Также добавлен X-Admin-Token в allow_headers для админ-авторизации.
app.add_middleware( app.add_middleware(
CORSMiddleware, CORSMiddleware,
allow_origins=[FRONTEND_ORIGIN], allow_origins=FRONTEND_ORIGINS,
allow_credentials=False, allow_credentials=False,
allow_methods=["GET", "POST", "PUT", "DELETE", "OPTIONS"], allow_methods=["GET", "POST", "PUT", "DELETE", "OPTIONS"],
# 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — добавлен Authorization в явный список. # 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — добавлен Authorization в явный список.
@@ -335,6 +337,7 @@ app.add_middleware(
"Authorization", "Authorization",
"Content-Type", "Content-Type",
"X-Telegram-InitData", "X-Telegram-InitData",
"X-Admin-Token",
], ],
) )
@@ -361,6 +364,7 @@ app.include_router(admin.router)
app.include_router(feed.router) app.include_router(feed.router)
app.include_router(admin_content.router) app.include_router(admin_content.router)
app.include_router(lectures.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 отчёт (реальный юзер, реальная БД) # 🧪 Smoke-test отчёт (реальный юзер, реальная БД)
**Дата:** 2026-09-26 09:36 UTC **Дата:** 2026-09-26 09:54 UTC
**Итого:** 53/53 сценариев прошли **Итого:** 77/77 сценариев прошли
## ✅ Подтверждено рабочим ## ✅ Подтверждено рабочим
@@ -12,13 +12,13 @@
- **wordquiz_wrong_answer** (wordquiz) — status=200, mistakes 0→1 - **wordquiz_wrong_answer** (wordquiz) — status=200, mistakes 0→1
- **bubblewords_complete_flow** (bubblewords) — status=200, levels 0→1, score 0→100 - **bubblewords_complete_flow** (bubblewords) — status=200, levels 0→1, score 0→100
- **sentences_check_wrong** (sentences) — status=200, score 0→0 (неверный) - **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 - **users_set_language** (users) — status=200, lang pl→ru
- **achievements_track_login** (achievements) — status=200, logins 0→1 - **achievements_track_login** (achievements) — status=200, logins 0→1
- **learning_levels_list** (learning) — status=200, уровней=6 - **learning_levels_list** (learning) — status=200, уровней=6
- **learning_topics_list** (learning) — status=200, тем A1=15 - **learning_topics_list** (learning) — status=200, тем A1=15
- **learning_topic_detail** (learning) — status=200, topic_id=a1_greetings, уроков=10 - **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_session_full_flow** (learning) — answer=True, recorded=True, complete=True, is_completed=True
- **learning_progress** (learning) — status=200, тем=27 - **learning_progress** (learning) — status=200, тем=27
- **learning_lesson_detail** (learning) — status=200, lesson=True, questions=True, examples=True - **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_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_start_or_resume** (teacher) — status=200, type=lesson_explanation, session_recorded=True
- **teacher_resume_no_session** (teacher) — status=200, has_active_session=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_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_save_load** (teacher) — save=True, load=True, messages_match=True
- **teacher_history_clear** (teacher) — status=200, remaining=0 - **teacher_history_clear** (teacher) — status=200, remaining=0
@@ -39,7 +39,7 @@
- **assistant_stats_personal** (assistant) — status=200, level=A1, score=240 - **assistant_stats_personal** (assistant) — status=200, level=A1, score=240
- **assistant_stats_admin_forbidden** (assistant) — status=403 (ожидали 403 — тестовый юзер не админ) - **assistant_stats_admin_forbidden** (assistant) — status=403 (ожидали 403 — тестовый юзер не админ)
- **support_user_tickets** (support) — status=200, тикетов=0 - **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 - **support_unread_count** (support) — status=200, unread_count=0
- **admin_dashboard_forbidden** (admin) — status=403 (ожидали 403 — тестовый юзер не админ) - **admin_dashboard_forbidden** (admin) — status=403 (ожидали 403 — тестовый юзер не админ)
- **admin_sentry_errors_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 - **hints_remaining** (hints) — status=200, used=2/3, remaining=1
- **game_progress** (game) — status=200, last=1, score=240 - **game_progress** (game) — status=200, last=1, score=240
- **game_check_word** (game) — status=200, found=False (координаты произвольные) - **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 - **admin**: 2/2
- **assistant**: 4/4 - **admin_content**: 8/8
- **bubblewords**: 1/1 - **admin_feed**: 4/4
- **assistant**: 5/5
- **bubblewords**: 3/3
- **feed**: 1/1 - **feed**: 1/1
- **game**: 3/3 - **game**: 3/3
- **hints**: 3/3 - **hints**: 3/3
- **leaderboard**: 1/1 - **leaderboard**: 1/1
- **learning**: 10/10 - **learning**: 10/10
- **pronunciation**: 1/1 - **pronunciation**: 1/1
- **sentences**: 1/1 - **sentences**: 4/4
- **support**: 3/3 - **support**: 3/3
- **teacher**: 8/8 - **teacher**: 8/8
- **typing**: 1/1 - **typing**: 4/4
- **users**: 3/3 - **users**: 3/3
- **wordquiz**: 2/2 - **wordquiz**: 4/4