Skip to content

[pull] main from googleapis:main#493

Merged
pull[bot] merged 1 commit into
Jaleel-zhu:mainfrom
googleapis:main
May 15, 2026
Merged

[pull] main from googleapis:main#493
pull[bot] merged 1 commit into
Jaleel-zhu:mainfrom
googleapis:main

Conversation

@pull
Copy link
Copy Markdown

@pull pull Bot commented May 15, 2026

See Commits and Changes for more details.


Created by pull[bot] (v2.0.0-alpha.4)

Can you help keep this open source service alive? 💖 Please sponsor : )

### Description

The previous Python ADK `user_identity` code example in the docs
recommended a `scopes` array that requested only
`"https://www.googleapis.com/auth/cloud-platform"`.

This omitted the standard `"openid"` protocol scope. In Google's OAuth2
ecosystem, omitting `"openid"` forces Google to issue a standard, opaque
**Access Token** instead of a signed **ID Token (JWT)**. Because the
self-hosted Toolbox server relies on local JWT validation to
cryptographically verify connection handshakes and parameter injections
instantly in memory, running this documented example out-of-the-box
immediately resulted in immediate connection validation crashes (`401
Unauthorized` or `403 Forbidden`) for developers.

#### Changes
1. Updated the `user_identity` credentials strategy in the
`python-sdk/adk/index.md` code snippet to correctly request `"openid"`
and `"email"` to guarantee OIDC JWT token delivery.
2. Created a warning block to explain the strict cryptographic necessity
of `"openid"` for OIDC identity verification, while explaining that
further resource scopes are optional depending on tool config.
@pull pull Bot locked and limited conversation to collaborators May 15, 2026
@pull pull Bot added the ⤵️ pull label May 15, 2026
@pull pull Bot merged commit 6002c5f into Jaleel-zhu:main May 15, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant