Updated on 2024-12-30 GMT+08:00

Logging Out Globally

Function

When a user logs out of a third-party application system, the session of the application system is terminated and the SSO ticket generated by OneAccess is destroyed. After the SSO ticket is destroyed, the browser performs a redirection to the callback URL specified by the application.

Constraints

null

URI

GET /api/v1/logout

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

redirect_url

No

String

Redirection address used after logout. The address must be URL-encoded. If this parameter is not set, the login page is displayed.

Request Parameters

None

Response Parameters

None

Example Requests

Log out of OneAccess globally and redirect to the application callback address https://example.com.

GET https://{domain_name}/api/v1/logout?redirect_url= https://example.com

Example Responses

None

Status Codes

Status Code

Description

302

By default, users are redirected to the login page. If redirect_url is specified, users are redirected to this address instead.

Error Codes

See Error Codes.