GET | Listar todas as sessões remotas

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

Acessa informações sobre todas as sessões proxy registradas no PAM Core.

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 todas as sessões, é necessário que o usuário tenha permissão de acesso para Credentials and Devices na autorização.

GET /api/session/remotesessions

Exemplo de requisição

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

Resposta

Atenção

Dependendo da quantidade de sessões registradas no ambiente, a lista retornada pode ser muito longa e o tempo de resposta pode demorar alguns minutos.

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "remote_sessions": [
        {
            "id": "3",
            "user": "Admin",
            "origin_ip": "172.16.20.125",
            "credential": "usrdomadm01",
            "device": "10.66.33.15:3389",
            "protocol": "rdp",
            "proxy": "Web Proxy",
            "session_id": "e7acacb6aedbab70073456da5744166939b77527",
            "start": "2024-05-06 16:05:07",
            "end": "2024-05-06 16:07:59",
            "time": "00:02:52",
            "prevent_purge": "No",
            "request": null,
            "ITSM": null
        },
        {
            "id": "6",
            "user": "Admin",
            "origin_ip": "172.16.20.125",
            "credential": "usrsudonopass",
            "device": "10.66.33.17:22",
            "protocol": "ssh",
            "proxy": "Web Proxy",
            "session_id": "c819cbc5f2fad2065f1d132a22d0e2dfacccb228",
            "start": "2024-05-06 16:11:17",
            "end": "2024-05-06 16:11:30",
            "time": "00:00:13",
            "prevent_purge": "No",
            "request": null,
            "ITSM": null
        }
    ]
 }

Campos do corpo da resposta

Info
  • 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.
  • Esse valor é automaticamente atribuído pelo Segura no momento de criação da sessão e não deve ser confundido com o parâmetro session_id.
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 que realizou a sessão. -
origin_ip String Endereço IP do usuário que realizou a sessão. -
credential String Credencial usada para realizar a sessão. -
device String Nome do host ou endereço IP do dispositivo de destino e a porta de acesso. -
protocol String Protocolo de rede (SSH, RDP, HTTPS, entre outros) -
proxy String Tipo de sessão proxy (Web Proxy, RDP Proxy, Terminal 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 prevenção de exclusão automática dos dados de uma sessão. Caso marcado como sim, não será possível realizar purge na 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
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 Segura. Contate o time de suporte para mais informações.
- - "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 A2A.
- Client authentication failed "Client authentication failed" Falha na autenticação da sua aplicação com o servidor Segura. 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.