From 453db5b91c7dca77622f3698b66e4d528687c200 Mon Sep 17 00:00:00 2001 From: Drobysh Date: Sun, 27 Sep 2026 07:54:32 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=90=20Admin=20auth=20+=20Lectures=20ba?= =?UTF-8?q?ckend?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Новое: - 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 — отчёт робота --- auth.py | 86 +++++++++++++++-------------- config.py | 19 ++++++- main.py | 10 +++- routers/admin_auth.py | 124 ++++++++++++++++++++++++++++++++++++++++++ smoke_test_report.md | 50 +++++++++++++---- 5 files changed, 232 insertions(+), 57 deletions(-) create mode 100644 routers/admin_auth.py diff --git a/auth.py b/auth.py index edab3e8..c4fb494 100644 --- a/auth.py +++ b/auth.py @@ -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 . - Приоритет источников: - 1. Authorization: tma — новый способ (фронт 23.09+) - 2. X-Telegram-InitData — старый способ (фронт до 23.09) - 3. query-параметр initData — fallback для deleteFeedPost - (осознанное исключение из-за - Cloudflare preflight-кеша) + Два режима: + 1. X-Admin-Token: — админка через браузер (26.09.2026) + 2. Authorization: tma — Telegram Mini App - Zero-downtime: старые и новые клиенты работают одновременно. + Приоритет: + 1. X-Admin-Token — если есть, проверяем JWT. + 2. Authorization: tma — основной для 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 (новый способ) + # 2.1. Authorization: tma 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 ' " - "or 'X-Telegram-InitData' or query parameter 'initData'" + "Authorization required. Pass 'X-Admin-Token' or " + "'Authorization: tma ' 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 \ No newline at end of file diff --git a/config.py b/config.py index 8e583e5..20ce11c 100644 --- a/config.py +++ b/config.py @@ -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"] \ No newline at end of file +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", "") \ No newline at end of file diff --git a/main.py b/main.py index 7cf1d94..a7dead1 100644 --- a/main.py +++ b/main.py @@ -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) # ============ Базовые эндпоинты ============ diff --git a/routers/admin_auth.py b/routers/admin_auth.py new file mode 100644 index 0000000..a9db37a --- /dev/null +++ b/routers/admin_auth.py @@ -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, + } diff --git a/smoke_test_report.md b/smoke_test_report.md index 12ad867..f1bb27a 100644 --- a/smoke_test_report.md +++ b/smoke_test_report.md @@ -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