GET | Listar uma sessão remota por [id]

  • 3 minuto(s) lido(s)
Prev Next

Acessa informações de uma sessão proxy registrada no PAM Core a partir do id da sessão.

Requisitos

  • Autorização com permissão de acesso ao PAM Core.
  • Sessões remotas iniciadas no PAM Core.

Requisição

Alerta

Para realizar a listagem de uma sessão através do seu id, é necessário que o usuário tenha permissão de acesso para Credentials and Devices na autorização.

GET api/pam/session/remotesessions/[id]

Parâmetros da requisição

Info

O valor do campo id é atribuído automaticamente pelo Segura no momento de criação da sessão e é obtido na resposta da requisição.

Parâmetro Tipo Obrigatório Descrição
id Inteiro Sim Código único de identificação da sessão.

Exemplo de requisição

GET {{url}}/api/session/remotesessions/{id}

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "remote_session": [
        {
            "id": "30",
            "user": "MFASenhaSegura",
            "origin_ip": "172.16.20.158",
            "credential": "usrsudonopass",
            "device": "10.66.33.17:22",
            "protocol": "ssh",
            "proxy": "Web Proxy",
            "session_id": "df06257a1eb71ddf9e584d57a83a7eee9104dc43",
            "start": "2024-05-15 17:37:53",
            "end": "2024-05-15 17:38:00",
            "time": "00:00:07",
            "prevent_purge": "No",
            "request": null,
            "ITSM": null
        }
    ]
}

Campos do corpo da resposta

Info
  • O valor para id é atribuído automaticamente pela plataforma Segura no momento de criação da sessão e não deve ser confundido com o parâmetro session_id.
  • O identificador session_id é usado internamente pela aplicação para operações relacionadas à sessão, tais como controle de acesso, rastreamento de atividades e gerenciamento de recursos. Cada vez que uma sessão é iniciada, um novo session_id é gerado para essa sessão específica.
Campo Tipo Descrição Exemplo
remote_sessions Array de objetos Dados das sessões remotas listadas. -
id Inteiro Código único de identificação da sessão remota. -
user String Nome de usuário utilizado para autenticação. -
origin_ip String Endereço IP do dispositivo de origem da sessão. -
credential String Credencial usada para realizar a sessão. -
device String Nome do host ou endereço IP do dispositivo de destino. -
protocol String Protocolo de rede (SSH, RDP, HTTPS, entre outros). -
proxy String Tipo de sessão proxy. -
session_id String Hash único gerado pelo Segura para identificar exclusivamente uma sessão específica. e7acacb6aedbab70073456da5744166939b77527
start String Data e hora de início da sessão em formato ISO 8601. 2024-05-06 16:05:07
end String Data e hora de término da sessão em formato ISO 8601. 2024-05-06 16:07:59
time String Duração da sessão. 00:02:52
prevent_purge String Indica se haverá a exclusão automática dos dados de uma sessão. No
request String Solicitação feita pelo usuário. -
ITSM String Código do software ITSM. -

Erros mais comuns

Código HTTP Erro Mensagem Possível Causa Solução
400 Bad Request "1002: Session not found" Sessão não encontrada. Verifique o id enviado para buscar pela sessão e envie a requisição novamente.
404 Not Found "Resource sub not found" A URL ou o recurso solicitado não está correto. Verifique a URL e envie a requisição novamente.
500 Internal Server Error "Unexpected error." O erro está no servidor. Contate o time de suporte para mais informações.
- Authorization Error "You are not authorized to access this resource" Você não possui autorização para acessar esse recurso. Solicite ao administrador que revise sua permissão de acesso aos recursos do PAM Core no A2A.
- Client authentication failed "Client authentication failed" Falha na autenticação da sua aplicação com o servidor. Verifique os parâmetros de autenticação como Access Token, Client ID e Client secret e solicite um novo token de acesso.
- No route matched with those values "No route matched with those values" Ausência do header de autorização na requisição de API. Solicite um novo token de acesso.
- Request timed out "Request timed out" O tempo da requisição se esgotou. Verifique a conectividade entre a origem da requisição e o servidor.