session.info

The session.info command is used to obtain information about the current session.

TR50 Request

{
  "cmd": {
    "command": "session.info"
  }
}

Request Parameters

The command takes no parameters. It only returns for the current session.

TR50 Response

If the command is sent successfully a success message and params list is returned. Otherwise, an error and error message will be returned.

{
    "1": {
        "success": true,
        "params": {
            "id": "5dja9dna733180364e973f2c63a8cc2",
            "ref": "d6c8e12879cc2ajda9h68b3b91f24a43c72a2c74486f4b5b04fa4b1f",
            "serverId": "server",
            "orgId": "5c99185csian03ec52c82",
            "orgKey": "Example",
            "userId": "5758sbc0hbe93e32c",
            "userName": "example@telit.com",
            "whoAmI": "example@telit.com",
            "ipAddress": "00.111.222.33",
            "hasSuperAdmin": true,
            "hasSuperOps": false,
            "hasOrgAdmin": true,
            "hasOrgOps": false,
            "orgOperations": [],
            "disablements": [],
            "connInfo": {
                "protocol": "HTTP",
                "remoteAddr": "00.111.222.33"
            },
            "ttl": 86400,
            "locale": "en_US",
            "allowSubOrgAccess": null,
            "startTime": "2024-02-29T16:56:05.465Z",
            "lastAccessed": "2024-02-29T18:44:44.036Z",
            "allAgreementsSigned": true,
            "initial": false,
            "orgProfileSettings": {
                "maxRetention": -1,
                "enCloudTriggers": true,
                "enCampaigns": true,
                "enCdpAccess": true,
                "enEuicc": false,
                "disableMgmtPortal": false,
                "disableCustObjDefs": false
            }
        }
    }
}

The returned session information for a user with Admin privileges will not include the 'perms' or the 'roleKeys' parameters.

Response Parameters

Response results will differ between a user-based session and an application-based session.

Name	Type	Description
ref	String	Ref is an identifier of session.
serverId	String	The unique identifier of the current server.
orgId	String	A unique identifier for the sessions current organization.
orgKey	String	The key of the current session organization.
appName	String	In an application session this is the name of the current application.
tokenId	String	In an application session this is the current applicationToken.
tokenName	String	In an application session this is the name of the current applicationToken.
thingKey	String	In an application session this is the thingKey of the current Thing.
userId	String	In a user session this is a unique identifier for the current user.
userName	String	In a user session this is the user name for the current user.
whoAmI	String	A string identifying the current application or user.
hasSuperAdmin	Boolean	True if the current session has Super Administration access.
hasSuperOps	Boolean	True if the current session has Super Ops access.
hasOrgAdmin	Boolean	True if the current session has Organization Administration access.
hasOrgOps	Boolean	True if the current session has Org Ops access.
orgOperations	Array	An array of operations the session has permission to use.
disablements	Array	An array of services and commands that the user will not be able to use.
connInfo	Object	Connection details for the current session.
connInfo.protocol	String	The connection protocol being used.
connInfo.remoteAddr	String	The remote address of the connection.
ttl	Integer	TTL (time to live) value for the current session.
locale	String	The localization and language setting for the current session.
perms	Object	Identifies the list of permissions available to the session and the boolean setting.
roleKeys	String	Identifies the list of Roles assigned to the User that owns this session.
support	Boolean	Whether the user has access to the support system.
maxThings	Integer	The maximum number of Things allowed in the profile.
maxCampaignSize	Integer	The maximum campaign size allowed in the profile.
maxRetention	Integer	The maximum retention, in days.
enCloudTriggers	Boolean	If true, then the cloud triggers are enabled.
enCampaigns	Boolean	If true, then the campaigns are enabled.
enCdpAccess	Boolean	If true, then the CDP access is enabled.
enEuicc	Boolean	Whether eUICC is enabled.
disableMgmtPortal	Boolean	If true, then users won't be able to log into the management portal. The disableMgmtPortal prevents access to the features of Management Portal. It doesn't prevent API access.
disableCustObjDefs	Boolean	If true, the lwm2m.metadata.register/deregister will not be executed and an error will be returned.
passwordExpiry	Timestamp	The date when the user's password expires and must be changed.

PHP API

mixed TR50httpWorker::sessionInfo();