120 lines
4.4 KiB
Python
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)
|