Zelestra

Zelestra Standards

getSessionInfo

The getSessionInfo operation returns information associated with the local security context for the current session. If a local security context has not been established, then a passive single sign-on process is employed to establish the security context local to this provider.

Request

The getSessionInfo operation does not require any data.

Operation

The information is obtained from the security context and returned.

Response

Examples

JSON:
{ "user":"http://www.zelestra.com/users/user01.xml",
  "agent":"http://www.zelestra.com/agents/agent01.xml",
  "virtualSpace":"http://www.zelestra.com/virtualspace.xml" }

XML:
<getSessionInfoResponse>
  <User>http://www.zelestra.com/users/user01.xml</User>
  <Agent>http://www.zelestra.com/agents/agent01.xml</Agent>
  <VirtualSpace>http://www.zelestra.com/virtualspace.xml</VirtualSpace>
</getSessionInfoResponse>

What information is supplied in the response is dependent upon the type of provider responding to the request. For instance, providers that act purely as identity providers may only be able to supply the user URI.

The getSessionInfoResponse element MAY contain a User element. This element is the user URI associated with the security context local to this provider.

The getSessionInfoResponse element MAY contain an Agent element. This element is the agent URI associated with the security context local to this provider.

The getSessionInfoResponse element MAY contain a VirtualSpace element. This element is the virtual space URI associated with the security context local to this provider.

The getSessionInfoResponse element MAY contain additional namespace qualified elements per prior agreement between the requesting and responding providers.

Faults

The getSessionInfoResponse operation may return an unauthorized fault if this provider is unable to determine a security context from the specified artifact.

The getSessionInfoResponse operation may return an operationFailed fault if the service was unable to otherwise fulfill the request.