---
title: "GET | Listar todas as sessões remotas"
slug: "api-get-list-all-remote-sessions"
updated: 2026-03-04T12:05:17Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-get-list-all-remote-sessions"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GET | Listar todas as sessões remotas

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. |