- 1 minute to read
- Print
- DarkLight
- PDF
Terminate a proxy session
- 1 minute to read
- Print
- DarkLight
- PDF
This article presents how to terminate any proxy session in PAM Core via API, the available endpoints, the parameters needed, example requests, and responses on success or in case of errors.
Authorization
To get started, make sure PAM Core is listed under Authorized resources in your A2A module. For more information on authorization, access the How to create an authorization for an application documentation.
Authentication
Each request in the API must have the OAuth Consumer Key and the OAuth Token of the client.
For more information on authentication, access the How to authenticate an application documentation.
Methods
Terminate a proxy session
Request
To terminate a proxy session, send a request to the following endpoint:
DELETE /iso/session/drop/[session_id]
Use the endpoint above to trigger external systems, such as SIEM, into ending sessions based on the alerts sent by senhasegura.
Request parameters
Path
Field | Type | Required | Description | Example |
---|---|---|---|---|
session_id | String | Yes | Unique hash generated by senhasegura to exclusively identify a specific session. This identifier is internally used by the application for session-related operations, such as access control, activity tracking, and resource management. Each time a session is initiated, a new session_id is generated for that specific session. The session_id can be obtained in the response to the request to List all sessions. | 3fcf1e4a16104e328d6794e1b9693cfc457871d2 |
Return
Terminates a proxy session in PAM Core and returns a message with the reason for the termination process.
Expected response
HTTP/1.1 200 OK
{
"response": {
"status": 200,
"message": "Sessão interrompida com sucesso",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Sessão interrompida com sucesso",
"erro": false,
"cod_erro": 0
}
}
In case of error - an error occurred while dropping the session or invalid id
provided.
HTTP/1.1 500 INTERNAL SERVER ERROR
{
"response": {
"status": 500,
"message": "An error occurred while droping session",
"error": true,
"error_code": 1,
"detail": "",
"mensagem": "An error occurred while droping session",
"erro": true,
"cod_erro": 1
}
}