Version 3.2 Documentation

Session.get - REST API

Overview

Returns details of a session indicated by target_ust, without renewing it. Must be called by a logged in super-user.

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

Request

Name	Datatype	Optional	Notes
target_ust	string	---	UST of session to return details of
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
creation_time	datetime	Yes	When the session was created, in UTC
expiration_time	datetime	Yes	When the session will expire, in UTC
remote_addr	string	Yes	From what remote address the session was created
user_agent	string	Yes	Using what user agent the session was created

Usage

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

{
  "cid": "e0673f65704f74b2cd040fa6",
  "status": "ok",
  "creation_time": "2028-03-14T19:04:32",
  "expiration_time": "2028-03-14T20:04:32",
  "remote_addr": "127.0.0.1",
  "user_agent": "Firefox 139.0"
}
$