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

NameDatatypeOptionalNotes
target_uststring---UST of session to verify
current_uststring---Current user's session token (UST) - must belong to a super-user
current_appstring---Name of application that the call is attempted from

Response

NameDatatypeOptionalNotes
cidstring---Correlation ID assigned to request
statusstring---Overall status code
sub_statuslistYesReturned only if status is not "ok", a list of error or warning codes
expiration_timestringYesThe 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"
}
$