Terminate a proxy session
  • 1 minute to read
  • Dark
    Light
  • PDF

Terminate a proxy session

  • Dark
    Light
  • PDF

Article summary

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]
Info

Use the endpoint above to trigger external systems, such as SIEM, into ending sessions based on the alerts sent by senhasegura.

Request parameters

Path

FieldTypeRequiredDescriptionExample
session_idStringYesUnique 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
    }
}

Was this article helpful?

What's Next