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