GET | Listar todas as sessões remotas

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

Requisitos

• Autorização com permissão de acesso ao PAM Core concedida pelo administrador no A2A.
  Acesse o documento sobre Como criar uma autorização para uma aplicação para mais informações.

• Sessões remotas iniciadas no PAM Core.

Requisição

GET api/pam/session/remotesessions

Exemplo de requisição

GET {{url}}/api/pam/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.

HTTP/1.1 200 OK

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "remote_sessions": [
      {
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "senhasegura",
    "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

remote_sessions - array de objetos - Dados das sessões remotas listadas.

    →id - int - Código único de identificação sessão remota.

    Nota: esse valor é automaticamente atribuído pelo senhasegura no momento de criação da sessão e não deve ser confundido com o parâmetro session_id.

    →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 senhasegura para identificar exclusivamente uma sessão específica .

    Exemplo:e7acacb6aedbab70073456da5744166939b77527

    Nota: este identificador é 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.

    →start - string - Data e hora de início da sessão em formato ISO 8601.

    Exemplo: 2024-05-06 16:05:07

    →end - string - Data e hora de término da sessão em formato ISO 8601.

    Exemplo: 2024-05-06 16:07:59

    →time - string - Duração da sessão.

    Exemplo: 00:02:52

    →prevent_purge - string - Indica se haverá a exclusão automática dos dados de uma sessão .

    Exemplo: No

    →request - string - Solicitação feita pelo usuário.

    →ITSM - string - Código do software ITSM.

Erros

404 - Not Found.

---

Mensagem: "Resource sub not found"

Possível causa: a URL ou o recurso solicitado não está correto.

Solução: verifique a URL e envie a requisição novamente.

---

500 - Internal Server Error

---

Mensagem: "Unexpected error."

Possível causa: o erro está no servidor senhasegura.

Solução: contate o time de suporte para mais informações.

---

Mensagem: "You are not authorized to access this resource"

Possível causa: você não possui autorização para acessar esse recurso.

Solução: solicite ao administrador que revise sua permissão de acesso aos recursos do PAM Core no A2A.

---

Client authentication failed

---

Mensagem: "Client authentication failed"

Possível causa: falha na autenticação da sua aplicação com o servidor senhasegura.

Solução: 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

---

Mensagem: "No route matched with those values"

Possível causa: ausência do header de autorização na requisição de API.

Solução: solicite um novo token de acesso.

---

Request timed out

---

Mensagem: "Request timed out"

Possível causa: o tempo da requisição se esgotou.

Solução: verifique a conectividade entre a origem da requisição e o servidor senhasegura.