forked from mtusi2026/mtusi2026lab2
47 lines
1.9 KiB
Python
47 lines
1.9 KiB
Python
"""
|
||
Пароли и токены.
|
||
|
||
Пароль: 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()
|