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

Acesse informações de uma sessão proxy registrada 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ão proxy registrada no PAM Core.
  Acesse o documento sobre Como configurar uma sessão remota (proxy) para mais informações.

Requisição

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

Parâmetros de requisição

Envie o parâmetro abaixo no path da URL.

id - int - obrigatório - Código único de identificação da sessão.

Nota: esse valor é automaticamente atribuído pelo senhasegura no momento de criação da sessão e é obtido na resposta da requisição GET | Listar todas as sessões remotas.

Exemplo de requisição

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

Resposta

HTTP/1.1 200 OK 

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

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

400 - Bad Request

---

Mensagem: "1002: Session not found"

Possível causa: sessão não encontrada.

Solução: verifique o id enviado para buscar pela sessão e envie a requisição novamente.

---

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.