"""Пароли и токены сессий. ВСЁ ЗДЕСЬ — ЗАГЛУШКИ ДЛЯ САМОСТОЯТЕЛЬНОЙ РЕАЛИЗАЦИИ. Вопрос защиты: «Почему 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()")