""" Пароли и токены. Пароль: Argon2id (password KDF). Он специально медленный и требует память, поэтому перебор украденных хэшей дорог. Соль своя у каждого хэша. Токен сессии: 32 случайных байта (256 бит) из secrets — непрозрачная строка, не связанная с username/UUID. В БД кладём SHA-256 от токена: для случайного 256-битного значения быстрый хэш достаточен (перебирать нечего), а утечка таблицы sessions не даёт рабочих токенов. """ from __future__ import annotations import hashlib import secrets from argon2 import PasswordHasher from argon2.exceptions import InvalidHashError, VerificationError, VerifyMismatchError _hasher = PasswordHasher() # Argon2id, параметры по умолчанию библиотеки (RFC 9106 low-memory) # Хэш-заглушка: проверяем пароль даже для несуществующего пользователя, # чтобы по времени ответа нельзя было узнать, существует ли username. _DUMMY_HASH = _hasher.hash("dummy-password-for-timing") def hash_password(password: str) -> str: return _hasher.hash(password) def verify_password(password_hash: str | None, password: str) -> bool: try: return _hasher.verify(password_hash or _DUMMY_HASH, password) and password_hash is not None except (VerifyMismatchError, VerificationError, InvalidHashError): return False def needs_rehash(password_hash: str) -> bool: return _hasher.check_needs_rehash(password_hash) def new_token() -> str: return secrets.token_urlsafe(32) # 256 бит энтропии def token_hash(token: str) -> bytes: return hashlib.sha256(token.encode("utf-8")).digest()