Files
mtusi2026lab5/app/security.py
T

47 lines
1.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
Пароли и токены.
Пароль: 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()