Files
mtusi2026lab4/src/messenger/security.py
T
2026-10-22 17:27:32 +03:00

81 lines
3.8 KiB
Python

"""Пароли, токены и разбор заголовка Authorization.
Две разные задачи хеширования:
- пароль хешируется МЕДЛЕННОЙ функцией Argon2id с солью: перебор паролей по украденной
базе стоит дорого (каждая попытка — десятки миллисекунд и 19 МиБ памяти);
- токен сессии хешируется БЫСТРЫМ SHA-256: токен — 256 случайных бит, перебирать
его бессмысленно, а проверять его нужно на каждом запросе.
"""
import base64
import binascii
import hashlib
import re
import secrets
from argon2 import PasswordHasher
from argon2.exceptions import InvalidHashError, VerificationError
# Параметры Argon2id — минимальные из рекомендаций OWASP: m=19 МиБ, t=2, p=1.
# Больше памяти — дороже перебор, но и каждый вход дороже для сервера.
_hasher = PasswordHasher(time_cost=2, memory_cost=19 * 1024, parallelism=1)
# Hash заведомо неверного пароля. Если пользователя нет, всё равно выполняем проверку:
# ответ занимает столько же времени, и по задержке нельзя узнать, существует ли username.
_DUMMY_HASH = _hasher.hash("timing-equalizer-not-a-password")
TOKEN_BYTES = 32 # 32 байта = 256 бит энтропии (требование контракта)
PASSWORD_MIN, PASSWORD_MAX = 12, 128
USERNAME_RE = re.compile(r"[a-z0-9_]{3,32}") # то же правило, что при регистрации
MAX_BASIC_HEADER = 1024 # длинный заголовок не проверяем: не тратим CPU на заведомый мусор
def hash_password(password: str) -> str:
return _hasher.hash(password) # строка вида $argon2id$v=19$m=19456,t=2,p=1$<соль>$<hash>
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 (VerificationError, InvalidHashError):
return False
def new_token() -> str:
"""Непрозрачный случайный токен: не username, не UUID и не JWT."""
return secrets.token_urlsafe(TOKEN_BYTES)
def token_hash(token: str) -> bytes:
"""В БД и в кэше хранится только SHA-256 токена — сам токен знает лишь клиент."""
return hashlib.sha256(token.encode("utf-8")).digest()
def _split_scheme(header: str | None) -> tuple[str, str]:
scheme, _, value = (header or "").strip().partition(" ")
return scheme.lower(), value.strip()
def parse_basic(header: str | None) -> tuple[str, str] | None:
"""Authorization: Basic base64(username:password) -> (username, password) или None.
Пароль в UTF-8 и может содержать двоеточие: делим по ПЕРВОМУ двоеточию (RFC 7617).
"""
scheme, value = _split_scheme(header)
if scheme != "basic" or not value or len(value) > MAX_BASIC_HEADER:
return None
try:
decoded = base64.b64decode(value, validate=True).decode("utf-8")
except (binascii.Error, ValueError):
return None
username, sep, password = decoded.partition(":")
if not sep or not username.isascii():
return None
return username, password
def parse_bearer(header: str | None) -> str | None:
scheme, value = _split_scheme(header)
if scheme != "bearer" or not value or len(value) > 512 or " " in value:
return None
return value