Sso Auth Api Oidc Callback
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