From b7430635fa6f3a872f92f18937df85610907b3f6 Mon Sep 17 00:00:00 2001 From: Matthew Hughes Date: Thu, 16 Dec 2021 10:23:46 +1100 Subject: [PATCH] Document `verify_oauth2_token` raises ValueError These `ValueError`s can be raised by `google.auth.jwt.decode` e.g.: * https://github.com/googleapis/google-auth-library-python/blob/8f1e9cfd56dbaae0dff64499e1d0cf55abc5b97e/google/oauth2/id_token.py#L162 * https://github.com/googleapis/google-auth-library-python/blob/8f1e9cfd56dbaae0dff64499e1d0cf55abc5b97e/google/oauth2/id_token.py#L135 * https://github.com/googleapis/google-auth-library-python/blob/8f1e9cfd56dbaae0dff64499e1d0cf55abc5b97e/google/auth/jwt.py#L255 Handling of this is noted in the user docs [1] [1] https://developers.google.com/identity/sign-in/web/backend-auth --- google/oauth2/id_token.py | 1 + 1 file changed, 1 insertion(+) diff --git a/google/oauth2/id_token.py b/google/oauth2/id_token.py index 74899ae55..48f5b0a59 100644 --- a/google/oauth2/id_token.py +++ b/google/oauth2/id_token.py @@ -158,6 +158,7 @@ def verify_oauth2_token(id_token, request, audience=None, clock_skew_in_seconds= Raises: exceptions.GoogleAuthError: If the issuer is invalid. + ValueError: If token verification fails """ idinfo = verify_token( id_token,