Files
mtusi2026lab2/src/security.py
T
scarletsky 43daf18d04
Skeleton contracts / contracts (pull_request) Canceled after 0s
Лабораторная работа 2
2026-10-22 13:47:47 +03:00

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