40 lines
2.2 KiB
Python
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()")
|