aboutsummaryrefslogtreecommitdiff
path: root/.venv/lib/python3.12/site-packages/jwt/api_jwk.py
diff options
context:
space:
mode:
Diffstat (limited to '.venv/lib/python3.12/site-packages/jwt/api_jwk.py')
-rw-r--r--.venv/lib/python3.12/site-packages/jwt/api_jwk.py144
1 files changed, 144 insertions, 0 deletions
diff --git a/.venv/lib/python3.12/site-packages/jwt/api_jwk.py b/.venv/lib/python3.12/site-packages/jwt/api_jwk.py
new file mode 100644
index 00000000..02f4679c
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/jwt/api_jwk.py
@@ -0,0 +1,144 @@
+from __future__ import annotations
+
+import json
+import time
+from typing import Any
+
+from .algorithms import get_default_algorithms, has_crypto, requires_cryptography
+from .exceptions import (
+ InvalidKeyError,
+ MissingCryptographyError,
+ PyJWKError,
+ PyJWKSetError,
+ PyJWTError,
+)
+from .types import JWKDict
+
+
+class PyJWK:
+ def __init__(self, jwk_data: JWKDict, algorithm: str | None = None) -> None:
+ self._algorithms = get_default_algorithms()
+ self._jwk_data = jwk_data
+
+ kty = self._jwk_data.get("kty", None)
+ if not kty:
+ raise InvalidKeyError(f"kty is not found: {self._jwk_data}")
+
+ if not algorithm and isinstance(self._jwk_data, dict):
+ algorithm = self._jwk_data.get("alg", None)
+
+ if not algorithm:
+ # Determine alg with kty (and crv).
+ crv = self._jwk_data.get("crv", None)
+ if kty == "EC":
+ if crv == "P-256" or not crv:
+ algorithm = "ES256"
+ elif crv == "P-384":
+ algorithm = "ES384"
+ elif crv == "P-521":
+ algorithm = "ES512"
+ elif crv == "secp256k1":
+ algorithm = "ES256K"
+ else:
+ raise InvalidKeyError(f"Unsupported crv: {crv}")
+ elif kty == "RSA":
+ algorithm = "RS256"
+ elif kty == "oct":
+ algorithm = "HS256"
+ elif kty == "OKP":
+ if not crv:
+ raise InvalidKeyError(f"crv is not found: {self._jwk_data}")
+ if crv == "Ed25519":
+ algorithm = "EdDSA"
+ else:
+ raise InvalidKeyError(f"Unsupported crv: {crv}")
+ else:
+ raise InvalidKeyError(f"Unsupported kty: {kty}")
+
+ if not has_crypto and algorithm in requires_cryptography:
+ raise MissingCryptographyError(
+ f"{algorithm} requires 'cryptography' to be installed."
+ )
+
+ self.algorithm_name = algorithm
+
+ if algorithm in self._algorithms:
+ self.Algorithm = self._algorithms[algorithm]
+ else:
+ raise PyJWKError(f"Unable to find an algorithm for key: {self._jwk_data}")
+
+ self.key = self.Algorithm.from_jwk(self._jwk_data)
+
+ @staticmethod
+ def from_dict(obj: JWKDict, algorithm: str | None = None) -> PyJWK:
+ return PyJWK(obj, algorithm)
+
+ @staticmethod
+ def from_json(data: str, algorithm: None = None) -> PyJWK:
+ obj = json.loads(data)
+ return PyJWK.from_dict(obj, algorithm)
+
+ @property
+ def key_type(self) -> str | None:
+ return self._jwk_data.get("kty", None)
+
+ @property
+ def key_id(self) -> str | None:
+ return self._jwk_data.get("kid", None)
+
+ @property
+ def public_key_use(self) -> str | None:
+ return self._jwk_data.get("use", None)
+
+
+class PyJWKSet:
+ def __init__(self, keys: list[JWKDict]) -> None:
+ self.keys = []
+
+ if not keys:
+ raise PyJWKSetError("The JWK Set did not contain any keys")
+
+ if not isinstance(keys, list):
+ raise PyJWKSetError("Invalid JWK Set value")
+
+ for key in keys:
+ try:
+ self.keys.append(PyJWK(key))
+ except PyJWTError as error:
+ if isinstance(error, MissingCryptographyError):
+ raise error
+ # skip unusable keys
+ continue
+
+ if len(self.keys) == 0:
+ raise PyJWKSetError(
+ "The JWK Set did not contain any usable keys. Perhaps 'cryptography' is not installed?"
+ )
+
+ @staticmethod
+ def from_dict(obj: dict[str, Any]) -> PyJWKSet:
+ keys = obj.get("keys", [])
+ return PyJWKSet(keys)
+
+ @staticmethod
+ def from_json(data: str) -> PyJWKSet:
+ obj = json.loads(data)
+ return PyJWKSet.from_dict(obj)
+
+ def __getitem__(self, kid: str) -> PyJWK:
+ for key in self.keys:
+ if key.key_id == kid:
+ return key
+ raise KeyError(f"keyset has no key for kid: {kid}")
+
+
+class PyJWTSetWithTimestamp:
+ def __init__(self, jwk_set: PyJWKSet):
+ self.jwk_set = jwk_set
+ self.timestamp = time.monotonic()
+
+ def get_jwk_set(self) -> PyJWKSet:
+ return self.jwk_set
+
+ def get_timestamp(self) -> float:
+ return self.timestamp