from typing import Any, List from .auth_totp_types import TotpAlgorithm, TotpSettings from .crypto_hmac_sha1 import hmac_sha1 from .crypto_hmac_sha256 import hmac_sha256 from .encoding_base32_base32_decode import base32_decode MAX_SAFE = 9007199254740991 def is_totp_whole(value: Any) -> bool: """Whole number from 0 to 2^53 - 1: the range all three languages agree on.""" return type(value) is int and 0 <= value <= MAX_SAFE def check_totp_digits(digits: Any) -> None: if type(digits) is not int or digits not in (6, 7, 8): raise ValueError("digits must be 6, 7 or 8") def check_totp_algorithm(algorithm: Any) -> None: if algorithm not in ("SHA1", "SHA256"): raise ValueError("algorithm must be SHA1 or SHA256") def check_totp_settings(settings: TotpSettings) -> None: check_totp_algorithm(settings.algorithm) check_totp_digits(settings.digits) if not is_totp_whole(settings.period) or settings.period < 1: raise ValueError("period must be a whole number of seconds, 1 or more") def totp_secret_key(secret: str) -> List[int]: """The secret's bytes. Old Google Authenticator secrets are 80 bits, so 10 bytes is the least accepted; new ones from totp_secret are 16 or more.""" key = base32_decode(secret) if len(key) < 10: raise ValueError("secret must decode to at least 10 bytes") return key def hotp_from_key(key: List[int], counter: int, digits: int, algorithm: str) -> str: """RFC 4226 section 5.3: HMAC of the 8-byte big-endian counter, then dynamic truncation.""" message = list(counter.to_bytes(8, "big")) mac = hmac_sha1(key, message) if algorithm == "SHA1" else hmac_sha256(key, message) offset = mac[-1] & 15 binary = ((mac[offset] & 127) << 24) | (mac[offset + 1] << 16) | (mac[offset + 2] << 8) | mac[offset + 3] return str(binary % (10 ** digits)).zfill(digits) def hotp_code(secret: str, counter: int, digits: int, algorithm: TotpAlgorithm) -> str: """The RFC 4226 HOTP code for one counter value.""" if not is_totp_whole(counter): raise ValueError("counter must be a whole number from 0 to 2^53 - 1") check_totp_digits(digits) check_totp_algorithm(algorithm) return hotp_from_key(totp_secret_key(secret), counter, digits, algorithm)