Files
mtusi2026lab3/src/messenger/security.py
T
2026-11-06 18:09:01 +03:00

120 lines
4.4 KiB
Python

"""Пароли и токены: argon2id для пароля, случайный opaque-токен для доступа.
Пароль не хранится и не передаётся дальше: в базе лежит только строка argon2id.
KDF считает десятки миллисекунд, поэтому вызывается в рабочем потоке — цикл
событий не должен ждать хэширование.
"""
from __future__ import annotations
import base64
import binascii
import hashlib
import secrets
from functools import lru_cache
import anyio
from argon2 import PasswordHasher
from argon2.exceptions import Argon2Error, InvalidHashError
# Минимальные параметры Argon2id из OWASP Password Storage Cheat Sheet:
# m=19456 КиБ (19 МиБ), t=2, p=1. Память на проверку ограничена осознанно.
TIME_COST = 2
MEMORY_COST_KIB = 19456
PARALLELISM = 1
HASH_BYTES = 32
SALT_BYTES = 16
TOKEN_BYTES = 32
TOKEN_MIN_LENGTH = 32
BASIC_SCHEME = "basic"
BEARER_SCHEME = "bearer"
_DUMMY_PASSWORD = "messenger-dummy-password-never-matches"
_hasher = PasswordHasher(
time_cost=TIME_COST,
memory_cost=MEMORY_COST_KIB,
parallelism=PARALLELISM,
hash_len=HASH_BYTES,
salt_len=SALT_BYTES,
)
def _hash(password: str) -> str:
return _hasher.hash(password)
def _verify(password: str, stored_hash: str) -> bool:
"""True только при совпадении; неподходящий или испорченный хэш — тоже «нет»."""
try:
return _hasher.verify(stored_hash, password)
except (Argon2Error, InvalidHashError):
return False
@lru_cache(maxsize=1)
def _dummy_hash() -> str:
"""Хэш-заглушка: нужен, чтобы ответ про неизвестного пользователя стоил столько же."""
return _hash(_DUMMY_PASSWORD)
async def hash_password(password: str) -> str:
"""Хэширует пароль; длина пароля ограничена контрактом, усечения нет."""
return await anyio.to_thread.run_sync(_hash, password)
async def verify_password(password: str, stored_hash: str) -> bool:
return await anyio.to_thread.run_sync(_verify, password, stored_hash)
async def spend_verification_time() -> None:
"""Выполняет KDF впустую: время ответа не выдаёт существование пользователя."""
await anyio.to_thread.run_sync(_verify, _DUMMY_PASSWORD, _dummy_hash())
def new_token() -> str:
"""Opaque-токен сессии: 256 бит энтропии, длина не меньше требуемых 32 символов."""
return secrets.token_urlsafe(TOKEN_BYTES)
def token_fingerprint(token: str) -> str:
"""Ключ, под которым сессия лежит в хранилище: сам токен там не появляется."""
return hashlib.sha256(token.encode("utf-8")).hexdigest()
def _credentials(header: str | None, scheme: str) -> str | None:
"""Хвост заголовка Authorization, если схема совпала; иначе None."""
if not header:
return None
name, separator, value = header.strip().partition(" ")
if not separator or name.lower() != scheme:
return None
value = value.strip()
return value or None
def parse_basic(header: str | None) -> tuple[str, str] | None:
"""Разбирает `Authorization: Basic ...` в пару (username, password).
None означает «заголовка нет, схема не та или значение испорчено»; наружу все
эти случаи дают один и тот же 401, поэтому различать их незачем.
"""
encoded = _credentials(header, BASIC_SCHEME)
if encoded is None:
return None
try:
decoded = base64.b64decode(encoded + "=" * (-len(encoded) % 4), validate=True)
text = decoded.decode("utf-8")
except (binascii.Error, ValueError):
return None
username, separator, password = text.partition(":")
if not separator or not username:
return None
return username, password
def parse_bearer(header: str | None) -> str | None:
"""Токен из `Authorization: Bearer ...`; None — если заголовок не подходит."""
return _credentials(header, BEARER_SCHEME)