"""Password hashing (scrypt) and opaque session tokens.""" from __future__ import annotations import base64 import hashlib import hmac import os import secrets _SCRYPT_N = 2**14 _SCRYPT_R = 8 _SCRYPT_P = 1 _SCRYPT_DKLEN = 32 _SCRYPT_MAXMEM = 64 * 1024 * 1024 def hash_password(password: str) -> str: salt = os.urandom(16) digest = hashlib.scrypt( password.encode("utf-8"), salt=salt, n=_SCRYPT_N, r=_SCRYPT_R, p=_SCRYPT_P, dklen=_SCRYPT_DKLEN, maxmem=_SCRYPT_MAXMEM, ) return "scrypt${}${}${}${}${}".format( _SCRYPT_N, _SCRYPT_R, _SCRYPT_P, base64.b64encode(salt).decode("ascii"), base64.b64encode(digest).decode("ascii"), ) def verify_password(password: str, encoded: str) -> bool: try: scheme, n_raw, r_raw, p_raw, salt_raw, digest_raw = encoded.split("$") if scheme != "scrypt": return False expected = base64.b64decode(digest_raw, validate=True) actual = hashlib.scrypt( password.encode("utf-8"), salt=base64.b64decode(salt_raw, validate=True), n=int(n_raw), r=int(r_raw), p=int(p_raw), dklen=len(expected), maxmem=_SCRYPT_MAXMEM, ) except (ValueError, TypeError, MemoryError): return False return hmac.compare_digest(actual, expected) def new_session_token() -> str: # 48 random bytes -> 384 bits of entropy, encoded as an opaque URL-safe string. return secrets.token_urlsafe(48) def token_digest(token: str) -> str: return hashlib.sha256(token.encode("utf-8")).hexdigest()