# Deep Security Manager REST API

## Path: / rest / session

Describe a session.

Method Summary
Resource | Description
--- | ---
`GET /rest/session` | Describe a session.
`DELETE /rest/session` | End a session.
`POST /rest/session` | Assume a role using a SAML response from an authorized identity provider.

Method Detail
Describe a session. Output: `DescribeSessionResponse` - a {@link DescribeSessionResponse} with the session details. Cookie parameters: sID - a session ID returned by the Authentication API or the session API. Produces: application/json HTTP return codes: 200 - if the request is successful 403 - if the session ID is invalid
End a session. Output: `void` Cookie parameters: sID - a session ID returned by the Authentication API or the session API. Produces: application/json HTTP return codes: 204 - if the request is successful or if the session ID does not exist
Assume a role using a SAML response from an authorized identity provider. Input: `AssumeRoleWithSAMLRequest` - an `AssumeRoleWithSAMLRequest` containing the SAML document, the URN for the requested identity provider, and the URN for the requested role. Output: `AssumeRoleWithSAMLResponse` - an `AssumeRoleWithSAMLResponse` containing a session ID that can be used in future requests. Produces: application/json HTTP return codes: 200 - if the request is successful 400 - if the request is invalid

Copyright © 2017 Trend Micro Inc. All Rights Reserved.