83 lines
3.1 KiB
Python
83 lines
3.1 KiB
Python
"""Пароли, разбор Basic/Bearer и генерация токенов."""
|
|
import base64
|
|
import binascii
|
|
import hashlib
|
|
import re
|
|
import secrets
|
|
from typing import Optional, Tuple
|
|
|
|
from argon2 import PasswordHasher
|
|
from argon2.exceptions import InvalidHashError, VerificationError, VerifyMismatchError
|
|
|
|
USERNAME_RE = re.compile(r"^[a-z0-9_]{3,32}$")
|
|
|
|
# Argon2id (библиотека argon2-cffi). Параметры — рекомендация OWASP для
|
|
# Argon2id: m=19 MiB, t=2, p=1. Пароль хешируется целиком в UTF-8, без усечения.
|
|
_hasher = PasswordHasher(time_cost=2, memory_cost=19 * 1024, parallelism=1)
|
|
|
|
# Хеш-«пустышка»: проверка для несуществующего пользователя стоит столько же,
|
|
# сколько для существующего, — время ответа не выдаёт наличие username.
|
|
_DUMMY_HASH = _hasher.hash("dummy-password-for-timing-equalization")
|
|
|
|
# 32 байта случайности = 256 бит энтропии; base64url без padding = 43 символа.
|
|
TOKEN_BYTES = 32
|
|
MAX_TOKEN_LENGTH = 256
|
|
|
|
|
|
def hash_password(password: str) -> str:
|
|
return _hasher.hash(password)
|
|
|
|
|
|
def verify_password(password_hash: Optional[str], password: str) -> bool:
|
|
try:
|
|
return _hasher.verify(password_hash or _DUMMY_HASH, password) and bool(
|
|
password_hash
|
|
)
|
|
except (VerifyMismatchError, VerificationError, InvalidHashError):
|
|
return False
|
|
|
|
|
|
def new_token() -> str:
|
|
return secrets.token_urlsafe(TOKEN_BYTES)
|
|
|
|
|
|
def token_digest(token: str) -> bytes:
|
|
"""Токен высокоэнтропийный, поэтому для поиска достаточно быстрого SHA-256.
|
|
|
|
В отличие от пароля, перебор 256-битного токена невозможен, и KDF здесь
|
|
только замедлил бы каждый запрос.
|
|
"""
|
|
return hashlib.sha256(token.encode("ascii")).digest()
|
|
|
|
|
|
def parse_basic(header: Optional[str]) -> Optional[Tuple[str, str]]:
|
|
"""Authorization: Basic base64(username:password) -> (username, password)."""
|
|
if not header:
|
|
return None
|
|
scheme, _, value = header.strip().partition(" ")
|
|
if scheme.lower() != "basic" or not value.strip():
|
|
return None
|
|
try:
|
|
raw = base64.b64decode(value.strip(), validate=True)
|
|
decoded = raw.decode("utf-8")
|
|
except (binascii.Error, ValueError, UnicodeDecodeError):
|
|
return None
|
|
username, sep, password = decoded.partition(":") # двоеточие в пароле допустимо
|
|
if not sep or not USERNAME_RE.match(username):
|
|
return None
|
|
if not 12 <= len(password) <= 128:
|
|
return None
|
|
return username, password
|
|
|
|
|
|
def parse_bearer(header: Optional[str]) -> Optional[str]:
|
|
if not header:
|
|
return None
|
|
scheme, _, value = header.strip().partition(" ")
|
|
token = value.strip()
|
|
if scheme.lower() != "bearer" or not token or len(token) > MAX_TOKEN_LENGTH:
|
|
return None
|
|
if not token.isascii() or any(ch.isspace() for ch in token):
|
|
return None
|
|
return token
|