"""Password hashing, opaque sessions and signed pagination cursors.""" import base64 import hashlib import hmac import json import secrets SCRYPT_N = 2 ** 14 SCRYPT_R = 8 SCRYPT_P = 1 SCRYPT_DKLEN = 32 SCRYPT_MAXMEM = 64 * 1024 * 1024 DUMMY_PASSWORD_HASH = None def _b64encode(value): return base64.urlsafe_b64encode(value).decode("ascii").rstrip("=") def _b64decode(value): padding = "=" * (-len(value) % 4) return base64.urlsafe_b64decode(value + padding) def hash_password(password): salt = secrets.token_bytes(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, _b64encode(salt), _b64encode(digest) ) def verify_password(password, stored): try: algorithm, n, r, p, salt, digest = stored.split("$") if algorithm != "scrypt": return False expected = _b64decode(digest) actual = hashlib.scrypt( password.encode("utf-8"), salt=_b64decode(salt), n=int(n), r=int(r), p=int(p), dklen=len(expected), maxmem=SCRYPT_MAXMEM, ) return hmac.compare_digest(actual, expected) except (ValueError, TypeError): return False def dummy_password_hash(): global DUMMY_PASSWORD_HASH if DUMMY_PASSWORD_HASH is None: DUMMY_PASSWORD_HASH = hash_password(secrets.token_urlsafe(24)) return DUMMY_PASSWORD_HASH def new_session_token(): return secrets.token_urlsafe(32) def token_hash(token): return hashlib.sha256(token.encode("utf-8")).hexdigest() def _signature(secret, payload): return hmac.new(secret.encode("utf-8"), payload, hashlib.sha256).hexdigest()[:32] def encode_cursor(secret, payload): raw = json.dumps(payload, sort_keys=True, separators=(",", ":")).encode("utf-8") return _b64encode(raw) + "." + _signature(secret, raw) def decode_cursor(secret, value): if not value or "." not in value: raise ValueError("invalid cursor") encoded, signature = value.rsplit(".", 1) raw = _b64decode(encoded) if not hmac.compare_digest(_signature(secret, raw), signature): raise ValueError("invalid cursor") payload = json.loads(raw.decode("utf-8")) if not isinstance(payload, dict): raise ValueError("invalid cursor") return payload