Listar dados da sessão remota
  • 2 minutos de leitura
  • Tema escuro
    Tema claro
  • Pdf

Listar dados da sessão remota

  • Tema escuro
    Tema claro
  • Pdf

Resumo do artigo

Este documento apresenta como consultar dados de uma ou mais sessões remotas registradas no PAM Core via API, os endpoints disponíveis, os parâmetros necessários, exemplos de requisições e as respostas em caso de sucesso ou em caso de erros.

Autorização

Para começar, certifique-se de que o PAM Core esteja listado em Recursos autorizados no seu módulo A2A.
Para mais informações sobre a autorização de um aplicativo, acesse o documento sobre Como criar uma autorização para uma aplicação.

Autenticação

Cada requisição nas APIs deve conter a OAuth Consumer Key e o OAuth Token do cliente.
Para mais informações sobre a autenticação, acesse o documento sobre Como autenticar uma aplicação.

Métodos

Listar todas as sessões remotas

Requisição

Para consultar as informações de todas as sessões remotas registradas no PAM Core, envie uma requisição para o seguinte endpoint:

GET api/session/remotesessions

Retorno

Retorna todas as informações de sessões remotas registradas no PAM Core associadas ao acesso do seu usuário, e fornece informações sobre o processo de recuperação das informações.

Atenção

Dependendo da quantidade de sessões registradas no ambiente, a lista retornada pode ser muito longa.

Resposta esperada

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": [
        {
            "id": "540",
            "user": "Admin",
            "origin_ip": "172.16.20.50",
            "credencial": "win7",
            "dispositivo": "127.0.0.1:27500",
            "protocol": "rdp",
            "proxy": "RDP Proxy",
            "session_id": "421c83a3b10be439d4da33b6c140f53eaf448207",
            "start": "2020-11-17 15:29:21",
            "end": "2020-11-17 15:29:41",
            "time": "00:00:20",
            "prevent_purge": "Não",
            "request": null,
            "ITSM": "governance code"
        },
        {
            "id": "541",
            "user": "Admin",
            "origin_ip": "172.16.20.50",
            "credencial": "win7",
            "dispositivo": "127.0.0.1:27500",
            "protocol": "rdp",
            "proxy": "RDP Proxy",
            "session_id": "0ca5556cee9cf223c808a0828cab174939937d1d",
            "start": "2020-11-17 15:32:32",
            "end": "2020-11-17 15:33:02",
            "time": "00:00:30",
            "prevent_purge": "Não",
            "request": null,
            "ITSM": null
        },
    ]

 }

Listar uma sessão remota

Requisição

Para consultar as informações de uma sessão remota, envie uma requisição para o seguinte endpoint:

GET api/session/remotesessions/[id]

Parâmetros de requisição

Path

CampoTipoObrigatórioDescriçãoExemplo
idIntSimCódigo identificador único associado a cada entrada na tabela de sessões. Este valor é atribuído automaticamente pelo senhasegura ao criar uma URL autenticada para iniciar sessão web proxy para identificar cada registro de sessão de forma única e é obtido na resposta à requisição Listar todas as sessões remotas. Não deve ser confundido com o parâmetro session_id540

Retorno

Retorna todas as informações de uma sessão remota registrada no PAM Corebaseado em seu id, e fornece informações sobre o processo de recuperação dos dados.

Resposta esperada

HTTP/1.1 200 OK

{
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "remote_session": [
        {
            "id": "540",
            "user": "Admin",
            "origin_ip": "172.16.20.50",
            "credencial": "win7",
            "dispositivo": "127.0.0.1:27500",
            "protocol": "rdp",
            "proxy": "RDP Proxy",
            "session_id": "42138173871371wuhwqf448207",
            "start": "2020-11-17 15:29:21",
            "end": "2020-11-17 15:29:41",
            "time": "00:00:20",
            "prevent_purge": "Não",
            "request": null,
            "ITSM": "governance code"
        }
    ]
}


Em caso de erro - sessão remota não encontrada

HTTP/1.1 400 Bad Request
{
    "code": 400,
    "response": {
        "status": 400,
        "message": "1002: Session not found",
        "error": true,
        "error_code": 1,
        "detail": "",
        "mensagem": "1002: Session not found",
        "erro": true,
        "cod_erro": 1
    },
    "exception": {
        "code": 1002,
        "message": "1002: Session not found",
        "detail": null
    }
}

Em caso de erro - id inválido

HTTP/1.1 400 Bad Request
{
    "code": 400,
    "response": {
        "status": 400,
        "message": "1003: Unexpected identifier type",
        "error": true,
        "error_code": 1,
        "detail": "",
        "mensagem": "1003: Unexpected identifier type",
        "erro": true,
        "cod_erro": 1
    },
    "exception": {
        "code": 1003,
        "message": "1003: Unexpected identifier type",
        "detail": null
    }
}


Este artigo foi útil?