Session.verify - REST API

Overview

Returns a boolean flag to indicate whether a session from target_ust exists or not, without renewing it. Must be called by a logged in super-user.

Note that False will be returned if the session already expired or if its user's password expired.

  • HTTP method: POST
  • 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
is_validboolYesTrue if target_ust points to an existing session, False otherwise

Usage

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

{
  "cid": "e0673f65704f74b2cd040fa6",
  "status": "ok",
  "is_valid": true
}
$