81 lines
3.8 KiB
Python
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
|