Sso Auth Api Oidc Callback

Sso Auth Api Oidc Callback
IdP redirect target (public)

On success answers 302 to a fixed internal path and sets VTP_SESSION and XSRF-TOKEN through the shared cookie helper; no return target is accepted and IdP tokens are never sent to the browser. On any failure answers 302 to the fixed internal login path /login, carrying only one fixed SsoErrorCode and no IdP-supplied text in the error query parameter (/login?error=). The request cookie is deleted on every outcome. Public: no session required.

Request
URI
GET
https://{api_host}/api/v1/auth/oidc/callback
COPY
Query Parameters
string
code
Optional

Authorization code; appears only in this IdP-to-callback URL and is redacted from logs

code example
example-authorization-code
string
state
Optional

Anti-CSRF state; single-use

state example
example-state-value
string
error
Optional

IdP error code, never echoed to the browser

error example
access_denied

Authentication
This operation uses the following authentication methods.
Responses
302

302 Found: redirect to / with the VTP_SESSION and XSRF-TOKEN cookies set on success, or to /login?error= on any denial or failure; the code and state parameters are optional and a missing one is a denial, not a 400

Operation doesn't return any data structure

Response Headers

string
Location

Redirect target


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/v1/auth/oidc/callback