Files
mtusi2026lab2/app/core/security.py
T

40 lines
2.2 KiB
Python

"""Пароли и токены сессий. ВСЁ ЗДЕСЬ — ЗАГЛУШКИ ДЛЯ САМОСТОЯТЕЛЬНОЙ РЕАЛИЗАЦИИ.
Вопрос защиты: «Почему hash пароля и быстрый checksum имеют разные задачи?»
* пароль имеет низкую энтропию -> нужен медленный KDF с солью (Argon2id);
* токен — 256 бит случайности -> брутфорс невозможен, хватает SHA-256,
а в БД храним только хеш токена (утечка БД не даёт рабочих токенов).
"""
def hash_password(password: str) -> str:
"""Хеширует пароль библиотечным KDF (рекомендуется argon2-cffi, Argon2id).
Возвращает строку с параметрами и солью внутри (формат PHC, "$argon2id$...").
"""
raise NotImplementedError("TODO: argon2.PasswordHasher().hash(password)")
def verify_password(password: str, password_hash: str) -> bool:
"""True, если пароль подходит. Любые ошибки верификации -> False, не исключение."""
raise NotImplementedError("TODO: PasswordHasher().verify + перехват VerifyMismatchError")
def dummy_verify_password(password: str) -> None:
"""Проверка «вхолостую» для несуществующего пользователя.
Нужна, чтобы время ответа на неверный username и на неверный пароль
не различалось (иначе по таймингу можно перебирать username).
"""
raise NotImplementedError("TODO: verify_password(password, заранее посчитанный DUMMY_HASH)")
def generate_token() -> str:
"""Opaque-токен минимум на 256 бит энтропии (secrets.token_urlsafe(32))."""
raise NotImplementedError("TODO: secrets.token_urlsafe(32)")
def hash_token(token: str) -> str:
"""Детерминированный хеш токена для хранения/поиска в БД (sha256 hexdigest)."""
raise NotImplementedError("TODO: hashlib.sha256(token.encode()).hexdigest()")