foo

Author: adamjmcgrath

auth0/v3/authentication/async_token_verifier.py

@@ -5,7 +5,7 @@
 
 
 class AsyncAsymmetricSignatureVerifier(AsymmetricSignatureVerifier):
-    """Verifier for RSA signatures, which rely on public key certificates.
+    """Async verifier for RSA signatures, which rely on public key certificates.
 
     Args:
         jwks_url (str): The url where the JWK set is located.
@@ -26,6 +26,10 @@ def set_session(self, session):
         self._fetcher.set_session(session)
 
     async def _fetch_key(self, key_id=None):
+        """Request the JWKS.
+
+        Args:
+        key_id (str): The key's key id."""
         return await self._fetcher.get_key(key_id)
 
     async def verify_signature(self, token):
@@ -45,7 +49,7 @@ async def verify_signature(self, token):
 
 
 class AsyncJwksFetcher(JwksFetcher):
-    """Class that fetches and holds a JSON web key set.
+    """Class that async fetches and holds a JSON web key set.
     This class makes use of an in-memory cache. For it to work properly, define this instance once and re-use it.
 
     Args:

auth0/v3/authentication/token_verifier.py

@@ -73,7 +73,7 @@ def _get_kid(self, token):
         return header.get("kid", None)
 
     def _decode_jwt(self, token, secret_or_certificate):
-        """Verifies the signature of the given JSON web token.
+        """Verifies and decodes the given JSON web token with the given public key or shared secret.
 
         Args:
             token (str): The JWT to get its signature verified.