Sessions
Realm Operations
Represents Sessions that can queried via a REST interface.
Resource path:
/sessions
Resource version: 5.1
getSessionInfo
It reads and returns the information about the requested session.
Usage
am> action Sessions --realm Realm --body body --actionName getSessionInfo
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }
getSessionInfoAndResetIdleTime
It reads and returns the information about the requested session. It also resets the session idle time.
Usage
am> action Sessions --realm Realm --body body --actionName getSessionInfoAndResetIdleTime
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }
getSessionProperties
It reads and returns all of the allowlisted properties for the requested session.
Usage
am> action Sessions --realm Realm --body body --actionName getSessionProperties
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }
logout
It logs out from OpenAM
Usage
am> action Sessions --realm Realm --body body --actionName logout
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }
logoutByHandle
It logs out sessions based on the provided session handles.
Usage
am> action Sessions --realm Realm --body body --actionName logoutByHandle
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Logout By Handle request", "type" : "object", "title" : "Logout By Handle request", "properties" : { "sessionHandles" : { "title" : "Session handles", "description" : "The array of session handles that needs to be invalidated.", "type" : "array", "items" : { "type" : "string" } } }, "required" : [ "sessionHandles" ] }
logoutByUser
No yet implemented, it will log out sessions based on the provided username and realm.
Usage
am> action Sessions --realm Realm --body body --actionName logoutByUser
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Logout By User request [not functional yet]", "type" : "object", "title" : "Logout By User request [not functional yet]", "properties" : { "username" : { "title" : "Username", "description" : "The username to identify the user whose sessions should be invalidated.", "type" : "string" } }, "required" : [ "username" ] }
query
It queries all sessions using the provided query filter.
Usage
am> query Sessions --realm Realm --filter filter
Parameters
- --filter
-
A CREST formatted query filter, where "true" will query all. Fields that can be queried: [username, realm]
refresh
Suggests to OpenAM that it should refresh this session (update it’s latest access time and reset its idleTime to 0). This will only be obeyed if the time between the session’s previous latest access time and now is greater than the value configured for the server’s Latest Access Time Update Frequency setting, which defaults to 60 seconds.
Usage
am> action Sessions --realm Realm --body body --actionName refresh
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }
updateSessionProperties
It updates and returns all of the allowlisted properties for the requested session.
Usage
am> action Sessions --realm Realm --body body --actionName updateSessionProperties
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }
validate
It checks whether the specified SSO Token Id is valid or not. If there is any problem getting or validating the token which causes an exception, the JSON response will be false. In addition, if the token is expired then the JSON response will be set to false. Otherwise it will be set to true.
Usage
am> action Sessions --realm Realm --body body --actionName validate
Parameters
- --body
-
The resource in JSON format, described by the following JSON schema:
{ "$schema" : "http://json-schema.org/draft-04/schema#", "description" : "Action request", "title" : "Action request", "type" : "object", "properties" : { "tokenId" : { "title" : "The tokenId", "description" : "The tokenId of the user you request information for", "type" : "string" } }, "required" : [ "tokenId" ] }