import base64 import hashlib import hmac import json import secrets import time PASSWORD_ALGORITHM = "pbkdf2_sha256" PASSWORD_ITERATIONS = 120_000 TOKEN_TTL_SECONDS = 60 * 60 * 24 * 7 def _b64url_encode(value: bytes) -> str: return base64.urlsafe_b64encode(value).decode("ascii").rstrip("=") def _b64url_decode(value: str) -> bytes: padding = "=" * (-len(value) % 4) return base64.urlsafe_b64decode(value + padding) def hash_password(password: str) -> str: salt = secrets.token_hex(16) digest = hashlib.pbkdf2_hmac( "sha256", password.encode("utf-8"), salt.encode("ascii"), PASSWORD_ITERATIONS, ).hex() return f"{PASSWORD_ALGORITHM}${PASSWORD_ITERATIONS}${salt}${digest}" def verify_password(password: str, stored_hash: str) -> bool: try: algorithm, iterations_raw, salt, expected = stored_hash.split("$", 3) iterations = int(iterations_raw) except (ValueError, AttributeError): return False if algorithm != PASSWORD_ALGORITHM: return False actual = hashlib.pbkdf2_hmac( "sha256", password.encode("utf-8"), salt.encode("ascii"), iterations, ).hex() return hmac.compare_digest(actual, expected) def create_auth_token(payload: dict[str, object], secret: str, ttl_seconds: int = TOKEN_TTL_SECONDS) -> str: token_payload = { **payload, "exp": int(time.time()) + ttl_seconds, } payload_json = json.dumps(token_payload, separators=(",", ":"), sort_keys=True).encode("utf-8") payload_part = _b64url_encode(payload_json) signature = hmac.new(secret.encode("utf-8"), payload_part.encode("ascii"), hashlib.sha256).digest() return f"{payload_part}.{_b64url_encode(signature)}" def verify_auth_token(token: str, secret: str) -> dict[str, object] | None: try: payload_part, signature_part = token.split(".", 1) except ValueError: return None expected_signature = hmac.new( secret.encode("utf-8"), payload_part.encode("ascii"), hashlib.sha256, ).digest() try: actual_signature = _b64url_decode(signature_part) except (ValueError, base64.binascii.Error): return None if not hmac.compare_digest(actual_signature, expected_signature): return None try: payload = json.loads(_b64url_decode(payload_part).decode("utf-8")) except (ValueError, UnicodeDecodeError): return None if int(payload.get("exp") or 0) < int(time.time()): return None return payload if isinstance(payload, dict) else None def normalize_username(username: str) -> str: return username.strip().lower() def generate_activation_code() -> str: groups = [secrets.token_urlsafe(4).replace("-", "X").replace("_", "Y").upper()[:6] for _ in range(3)] return "SL-" + "-".join(groups)