OIDC auth flow gets stuck if auth request is triggered by subagent

Open
#7,182 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
python

Research direction

Start by tracing the OIDC auth request from a subagent tool call through the ADK API server and ADK Web UI, then compare it with the working root-agent path. Reproduce the flow described in the issue and verify that subagent-triggered requests resolve normally and that the Web UI displays the auth pop-up rather than only a manual code field.

Written by the indexing model from the issue text.

Description

🔴 Required Information

Please ensure all items in this section are completed to allow for efficient
triaging. Requests without complete information may be rejected / deprioritized.
If an item is not applicable to you - please mark it as N/A

Describe the Bug:
We are currently experiencing problems when using the recommended OIDC auth flow (via Keycloak) for toolsets. The issue arises of the auth request is triggered by a tool call associated to a subagent (and not the root agent). This affects both the ADK Web UI as well as the ADK API server. For the former, the auth pop-up never shows up in such a case (instead, only a text box to enter a code manually is shown). By contrast, if the auth request is triggered by a tool call associated to the root agent, everything works as expected. Also, the issue arises with the current version 2.9.1 of ADK, but has also been observed with the earlier version 2.8.0.

Steps to Reproduce:

  1. Set up a root agent with a subagent, where the latter has a tool requiring auth with an OIDC flow
  2. Prompt the agent to make the subagent issue a tool call, triggering the auth request
  3. Observe that the auth is never resolved; in case of the ADK Web UI, the corresponding pop-up is never triggered but only shows a text box to enter a code
  4. The logs make absolutely no notice of this event

Expected Behavior:
Subagents should be treated in an equivalent manner as root agents when it comes to auth requests, resolving the auth flow as expected.

Observed Behavior:
In the case the auth request is triggered by a subagent, the auth flow gets stuck and is never resolved. In case of the ADK Web UI, the corresponding pop-up is never triggered.

Environment Details:

  • ADK Library Version (pip show google-adk): 2.9.1 (but also observed with 2.8.0)
  • Desktop OS:** Ubuntu 24.04.5 LTS inside WSL on Windows 11
  • Python Version (python -V): 3.13.13

Model Information:

  • Are you using LiteLLM: No
  • Which model is being used: gemini-3.7-flash via Vertex AI

🟡 Optional Information

Providing this information greatly speeds up the resolution process.

Regression:
Tested and confirmed with both 2.8.0 and 2.9.1, no information available about earlier versions.

Logs:
As mentioned above, the logs make absolutely no notice of the stuck auth flow. They are entirely inconclusive.

Screenshots / Video:
N/A

Additional Context:
N/A

Minimal Reproduction Code:
N/A

How often has this issue occurred?:
The problem is 100% reproducible with the described flow.

Dominant language
Python
Stars
21.6k
Forks
4k
Avg merge
13h 49m
Merged PRs (30d)
10

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from google/adk-python

All issues in google/adk-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.