fix(google): replace deprecated /oauth2/v1/tokeninfo with /oauth2/v3/userinfo (#3603)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
This commit is contained in:
AIKAWA Shigechika 2026-03-25 23:39:34 +09:00 committed by GitHub
commit c3f0223bbb
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 369 additions and 54 deletions

View file

@ -1,7 +1,11 @@
"""Tests for Google OAuth provider."""
import re
import time
import pytest
from key_value.aio.stores.memory import MemoryStore
from pytest_httpx import HTTPXMock
from fastmcp.server.auth.providers.google import (
GOOGLE_SCOPE_ALIASES,
@ -231,3 +235,302 @@ class TestGoogleScopeNormalization:
"""Verify the alias map covers the known Google shorthands."""
assert "email" in GOOGLE_SCOPE_ALIASES
assert "profile" in GOOGLE_SCOPE_ALIASES
# Regex patterns for URL matching (tokeninfo uses query params)
_TOKENINFO_RE = re.compile(r"https://oauth2\.googleapis\.com/tokeninfo")
_USERINFO_RE = re.compile(r"https://www\.googleapis\.com/oauth2/v2/userinfo")
class TestGoogleTokenVerifier:
"""Test GoogleTokenVerifier.verify_token() using the tokeninfo endpoint."""
TOKENINFO_URL = "https://oauth2.googleapis.com/tokeninfo"
USERINFO_URL = "https://www.googleapis.com/oauth2/v2/userinfo"
async def test_valid_token_openid_only(self, httpx_mock: HTTPXMock):
"""A token with only openid scope is accepted; client_id comes from 'aud'."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={"sub": "12345"},
)
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("valid-token")
assert result is not None
assert result.client_id == "123.apps.googleusercontent.com"
assert result.scopes == ["openid"]
assert result.expires_at is not None
assert result.claims["sub"] == "12345"
assert result.claims["aud"] == "123.apps.googleusercontent.com"
async def test_valid_token_with_email_and_profile(self, httpx_mock: HTTPXMock):
"""A token with email+profile scope returns correct scopes and profile claims."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"email": "user@example.com",
"email_verified": "true",
"scope": "openid https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/userinfo.profile",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={
"sub": "12345",
"email": "user@example.com",
"verified_email": True,
"name": "Test User",
"picture": "https://example.com/photo.jpg",
"given_name": "Test",
"family_name": "User",
"locale": "en",
},
)
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("valid-token")
assert result is not None
assert result.client_id == "123.apps.googleusercontent.com"
assert "openid" in result.scopes
assert "https://www.googleapis.com/auth/userinfo.email" in result.scopes
assert "https://www.googleapis.com/auth/userinfo.profile" in result.scopes
assert result.claims["email"] == "user@example.com"
assert result.claims["name"] == "Test User"
assert result.claims["picture"] == "https://example.com/photo.jpg"
async def test_expired_or_invalid_token_returns_none(self, httpx_mock: HTTPXMock):
"""HTTP 400 from tokeninfo endpoint causes verify_token to return None."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
status_code=400,
json={
"error": "invalid_token",
"error_description": "Token has been expired or revoked.",
},
)
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("expired-token")
assert result is None
async def test_missing_aud_returns_none(self, httpx_mock: HTTPXMock):
"""A 200 response without 'aud' is rejected."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={"sub": "12345", "scope": "openid", "expires_in": "3600"},
)
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("token-without-aud")
assert result is None
async def test_missing_sub_returns_none(self, httpx_mock: HTTPXMock):
"""A 200 response without 'sub' is rejected."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"scope": "openid",
"expires_in": "3600",
},
)
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("token-without-sub")
assert result is None
async def test_required_scopes_satisfied(self, httpx_mock: HTTPXMock):
"""Token with required scopes passes the scope check."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"email": "user@example.com",
"scope": "openid https://www.googleapis.com/auth/userinfo.email",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={"sub": "12345", "email": "user@example.com"},
)
verifier = GoogleTokenVerifier(
required_scopes=["openid", "email"],
)
result = await verifier.verify_token("valid-token")
assert result is not None
async def test_required_scopes_not_satisfied_returns_none(
self, httpx_mock: HTTPXMock
):
"""Token without required scopes is rejected."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid",
"expires_in": "3600",
},
)
verifier = GoogleTokenVerifier(
required_scopes=[
"openid",
"https://www.googleapis.com/auth/userinfo.email",
],
)
result = await verifier.verify_token("token-missing-email-scope")
assert result is None
async def test_uses_query_param_not_bearer_header(self, httpx_mock: HTTPXMock):
"""verify_token sends the token as a query parameter to tokeninfo, not a Bearer header."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={"sub": "12345"},
)
verifier = GoogleTokenVerifier()
await verifier.verify_token("my-access-token")
requests = httpx_mock.get_requests()
tokeninfo_req = requests[0]
assert "access_token=my-access-token" in str(tokeninfo_req.url)
assert "Authorization" not in tokeninfo_req.headers
async def test_calls_tokeninfo_endpoint(self, httpx_mock: HTTPXMock):
"""verify_token calls the tokeninfo endpoint, not the userinfo endpoint, for verification."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={"sub": "12345"},
)
verifier = GoogleTokenVerifier()
await verifier.verify_token("valid-token")
requests = httpx_mock.get_requests()
assert len(requests) >= 1
assert "tokeninfo" in str(requests[0].url)
assert "oauth2.googleapis.com" in str(requests[0].url)
async def test_expires_at_computed_from_expires_in(self, httpx_mock: HTTPXMock):
"""expires_at is set from expires_in returned by tokeninfo."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={"sub": "12345"},
)
before = int(time.time())
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("valid-token")
after = int(time.time())
assert result is not None
assert result.expires_at is not None
assert before + 3600 <= result.expires_at <= after + 3600
async def test_profile_data_fetched_from_userinfo(self, httpx_mock: HTTPXMock):
"""Profile data (name, picture, locale) comes from the v2 userinfo endpoint."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid https://www.googleapis.com/auth/userinfo.profile",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={
"sub": "12345",
"name": "Test User",
"picture": "https://example.com/photo.jpg",
"given_name": "Test",
"family_name": "User",
"locale": "en",
},
)
verifier = GoogleTokenVerifier()
result = await verifier.verify_token("valid-token")
assert result is not None
assert result.claims["name"] == "Test User"
assert result.claims["picture"] == "https://example.com/photo.jpg"
assert result.claims["given_name"] == "Test"
assert result.claims["family_name"] == "User"
assert result.claims["locale"] == "en"
async def test_non_openid_scopes_checked_correctly(self, httpx_mock: HTTPXMock):
"""Calendar scope is correctly checked from the tokeninfo scope string."""
httpx_mock.add_response(
url=_TOKENINFO_RE,
json={
"aud": "123.apps.googleusercontent.com",
"sub": "12345",
"scope": "openid https://www.googleapis.com/auth/calendar",
"expires_in": "3600",
},
)
httpx_mock.add_response(
url=_USERINFO_RE,
json={"sub": "12345"},
)
verifier = GoogleTokenVerifier(
required_scopes=["openid", "https://www.googleapis.com/auth/calendar"],
)
result = await verifier.verify_token("valid-token")
assert result is not None
assert "https://www.googleapis.com/auth/calendar" in result.scopes

View file

@ -421,22 +421,20 @@ class TestRateLimitingMiddlewareIntegration:
async def test_global_rate_limiting(self, rate_limit_server):
"""Test global rate limiting across all clients."""
rate_limit_server.add_middleware(
RateLimitingMiddleware(
max_requests_per_second=6.0,
burst_capacity=5, # 1 init + 2 list_tools + 2 calls before limit
global_limit=True, # Accounting for initialization and list_tools calls
)
middleware = RateLimitingMiddleware(
max_requests_per_second=0.001,
burst_capacity=1000,
global_limit=True,
)
rate_limit_server.add_middleware(middleware)
async with Client(rate_limit_server) as client:
# Use up the global capacity
await client.call_tool("quick_action", {"message": "1"})
await client.call_tool("quick_action", {"message": "2"})
# Should be globally rate limited
middleware.global_limiter.tokens = 0
with pytest.raises(ToolError, match="Global rate limit exceeded"):
await client.call_tool("quick_action", {"message": "3"})
await client.call_tool("quick_action", {"message": "blocked"})
async def test_rate_limiting_recovery_over_time(self, rate_limit_server):
"""Test that rate limiting allows requests again after time passes."""