Version 3.2 Documentation

Session.verify - REST API

Overview

Renews current session. Note that an error will be reported if the session has already expired or if its user's password is expired. On success, new expiration time is returned (in UTC).

HTTP method: PATCH
URL path: /zato/sso/user/session

Request

Name	Datatype	Optional	Notes
target_ust	string	---	UST of session to verify
current_ust	string	---	Current user's session token (UST) - must belong to a super-user
current_app	string	---	Name of application that the call is attempted from

Response

Name	Datatype	Optional	Notes
cid	string	---	Correlation ID assigned to request
status	string	---	Overall status code
sub_status	list	Yes	Returned only if status is not "ok", a list of error or warning codes
expiration_time	string	Yes	The renewed session's expiration time, in UTC

Usage

$ curl -XGET localhost:17010/zato/sso/user/session -d '
  {
    "target_ust": "gAAAAABaqXJAenbkYyQt9CoWIvq...",
    "current_ust": "gAAAAABanYJQziYsPwDYOFJSR5...",
    "current_app": "CRM"
  }
  '

{
  "cid": "e0673f65704f74b2cd040fa6",
  "status": "ok",
  "expiration_time": "2028-03-14T20:38:17.730640"
}
$