Files
mtusi2026lab2/app/core/security.py
T
2026-10-23 00:20:58 +03:00

70 lines
3.5 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Пароли и токены сессий. ВСЁ ЗДЕСЬ — ЗАГЛУШКИ ДЛЯ САМОСТОЯТЕЛЬНОЙ РЕАЛИЗАЦИИ.
Вопрос защиты: «Почему hash пароля и быстрый checksum имеют разные задачи?»
* пароль имеет низкую энтропию -> нужен медленный KDF с солью (Argon2id);
* токен — 256 бит случайности -> брутфорс невозможен, хватает SHA-256,
а в БД храним только хеш токена (утечка БД не даёт рабочих токенов).
Async: Argon2 — CPU-bound и занимает десятки миллисекунд. Вызов прямо из
`async def` блокирует event loop на всё это время, и ВСЕ остальные запросы
стоят. Поэтому hash/verify оборачиваются в `asyncio.to_thread`.
generate_token и hash_token — микросекунды, остаются обычными функциями.
"""
def _hash_password_sync(password: str) -> str:
"""Синхронный Argon2id-хеш. Вызывается только через asyncio.to_thread.
Алгоритм:
1. hasher = модульный PasswordHasher() (создать один раз на модуль)
2. return hasher.hash(password) # "$argon2id$..." с солью и параметрами
"""
raise NotImplementedError("TODO")
def _verify_password_sync(password: str, password_hash: str) -> bool:
"""Синхронная проверка. Вызывается только через asyncio.to_thread.
Алгоритм:
1. try: hasher.verify(password_hash, password); return True
2. except VerifyMismatchError / VerificationError / InvalidHashError: return False
"""
raise NotImplementedError("TODO")
async def hash_password(password: str) -> str:
"""Алгоритм: return await asyncio.to_thread(_hash_password_sync, password)."""
raise NotImplementedError("TODO")
async def verify_password(password: str, password_hash: str) -> bool:
"""Алгоритм: return await asyncio.to_thread(_verify_password_sync, password, password_hash)."""
raise NotImplementedError("TODO")
async def dummy_verify_password(password: str) -> None:
"""Проверка «вхолостую» для несуществующего пользователя.
Нужна, чтобы время ответа на неверный username и на неверный пароль
не различалось (иначе по таймингу можно перебирать username).
Алгоритм:
1. DUMMY_HASH = hash от случайной строки, посчитан один раз при импорте модуля
(через _hash_password_sync, не через await — на уровне модуля await нельзя)
2. await verify_password(password, DUMMY_HASH); результат игнорировать
"""
raise NotImplementedError("TODO")
def generate_token() -> str:
"""Opaque-токен минимум на 256 бит энтропии. Алгоритм: secrets.token_urlsafe(32)."""
raise NotImplementedError("TODO")
def hash_token(token: str) -> str:
"""Детерминированный хеш токена для хранения/поиска в БД.
Алгоритм: hashlib.sha256(token.encode()).hexdigest()
"""
raise NotImplementedError("TODO")