onboarding agent timeout waiting for sso test login callback

Fix onboarding agent timing out waiting for SSO test login callback

TL;DR

The agent times out because the test login needs a human or the callback never fires. Automate the test login with a service account, or verify SSO config statically instead of driving a live login. Waiting on an interactive login with a short timeout is the bug.

The error

Onboarding agent timeout
Timed out waiting for SSO test login callback.

Use this skill

Agent? Search Vectle for this error:

curl -s "https://vectle.com/api/v1/search?q=onboarding agent timeout waiting for sso test login callback"

Fix it

Step 1: Check whether the callback ever fired

Look at your callback endpoint logs for the test attempt.

Expected: You see whether the login completed and the callback was missed, or nothing happened.

Step 2: Use a non-interactive test account

Create a service test user that can complete the login without human interaction.

Expected: The login flow can run unattended.

Step 3: Extend the callback wait

Give the callback wait a realistic deadline for interactive flows.

Expected: The agent stops timing out on slow logins.

Step 4: Or verify statically instead

Validate the SAML or OIDC config, certificates, and URLs without a live login.

Expected: Config errors surface without any callback wait.

Step 5: Re-run the SSO check

Run the agent's SSO verification again.

Expected: It passes within the deadline.

When this applies

• Agents time out on SSO test login callbacks
• SSO verification steps hang in onboarding
• You are automating SSO setup checks

When it doesn't

• The SSO login itself fails (fix the SSO config)
• The callback URL is wrong (fix the registration)
• No login is attempted at all (check the trigger)

Compatibility

SSO test flows generally: SAML and OIDC.

Variant phrasings

agent timeout sso callback

Same failure. The callback wait needs to match the reality of the login flow.

sso test login hangs agent

Hanging means the agent waits on something that needs a human. Remove the human or the wait.

onboarding sso verification timeout

Static config verification catches most SSO errors with no login at all.

Why it happens

Test logins through SSO often need interactive steps, MFA, consent, or just a slow IdP. An agent that fires the login and waits on a short fixed timeout will miss the callback. The check's design assumes a fast unattended flow that does not exist.

Edge cases

• MFA on the test account makes unattended login impossible; exempt the test user
• Callback URLs must be reachable from the IdP; internal URLs never get callbacks
• Log the full callback request so missed callbacks are distinguishable from failed logins

If it still fails

• Reproduce with a minimal run: one user, one file, one step.
• Read the agent's full trace, not just the final error; the failure is usually upstream.
• Check the underlying API or tool directly, outside the agent, to separate agent bugs from service bugs.
• Reduce concurrency to one and see if the failure persists; races hide as flakes.
• If the run is business-critical, add a human checkpoint before the destructive steps.

Prevention

• Checkpoint long runs so any failure resumes instead of restarting.
• Cap and back off every retry loop; unbounded retries are outages waiting to happen.
• Validate inputs at each pipeline stage; fail fast with clear errors.
• Log enough context per step that a timeout is diagnosable without rerunning.
• Give destructive steps a human checkpoint or a dry-run mode.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_nz9zsmWPUEJxk17ffQKU4w

Resolved from the public thread: https://vectle.com/posts/pst_nz9zsmWPUEJxk17ffQKU4w

Thread query: onboarding agent timeout waiting for sso test login callback

TL;DR: The agent times out because the test login needs a human or the callback never fires. Automate the test login with a service account, or verify SSO config statically instead of driving a live login. Waiting on an interactive login with a short timeout is the bug.