GET | Listar todas as sessões remotas

Descrição

Liste as sessões remotas registradas no PAM Core, utilizando o modelo canônico v2. Retorna uma projeção paginada e filtrável da entidade SessionV2. Utilize-a para revisões de auditoria, monitoramento de SOC e sincronização incremental com SIEM.

Este endpoint é somente leitura. A criação e o encerramento de sessões não fazem parte da superfície v2.

Pré-requisitos

Este endpoint requer uma aplicação A2A com acesso à API e um token OAuth2 válido. Para mais informações, acesse Como gerenciar autorizações no A2A para a API v2.

Requisição

GET /api/v2/pam/sessions

Parâmetros de query

Todos os parâmetros de query são opcionais. Quando nenhum parâmetro é enviado, o endpoint retorna as sessões mais recentes usando a ordenação e o tamanho de página padrão.

Os nomes dos filtros são qualificados com o namespace ao qual pertencem, como session.status ou device.id. Nomes não qualificados retornam 400.

Filtros

Um valor de enum inválido retorna 422 api.enum.invalid_value. Um session.created_at_gte posterior ao session.created_at_lte retorna 422 api.validation.invalid_date_range.

Para as regras completas de validação de filtros e a lógica E/OU, consulte API v2 - Convenções e comportamentos compartilhados.

Busca

Diferente dos filtros, search não é qualificado com namespace. Enviar session.search retorna 400, e um termo com menos de três caracteres retorna 400 api.request.bad_request.

Ordenação

Os campos ordenáveis são session.created_at, session.started_at e session.ended_at. Um campo desconhecido retorna 422 api.sort.invalid_field, e uma direção diferente de asc ou desc retorna 422 api.sort.invalid_direction.

Os resultados incluem um critério de desempate interno único na mesma direção da ordenação. Isso mantém a paginação estável quando novas sessões são criadas enquanto você percorre as páginas.

Paginação

Um limit maior que 200 retorna 422 api.pagination.limit.exceeded.

Para sincronizar sessões de forma incremental, defina um piso com session.created_at_gte e siga meta.links.next até que o campo não esteja mais presente na resposta. Não percorra as páginas até meta.pagination.total_pages: os totais são informativos, e meta.links.next é a forma suportada de avançar.

Para as regras completas de paginação, consulte API v2 - Convenções e comportamentos compartilhados.

Projeção de campos

Uma chave desconhecida retorna 422 api.validation.invalid_field. Para as regras completas de projeção, consulte API v2 - Convenções e comportamentos compartilhados.

Exemplo de requisição

GET {{url}}/api/v2/pam/sessions?session.status=active&limit=50

Resposta

HTTP/1.1 200 OK

Um filtro que não encontra correspondência retorna 200 com o array data vazio, e não um erro.

Exemplo de corpo da resposta

{
    "data": [
        {
            "id": "789",
            "session": {
                "session_id": "S2026082912345",
                "session_type": "terminal_proxy",
                "protocol": "SSH",
                "status": "active",
                "user": "dalmeida",
                "justification": "Janela de manutenção MW-2026-0829",
                "access_period": null,
                "origin": "200.100.50.25",
                "selection_mode": "explicit",
                "created_at": "2026-08-29T12:34:56+00:00",
                "started_at": "2026-08-29T12:35:02+00:00",
                "ended_at": null,
                "duration": "00:15:32"
            },
            "device": {
                "id": 55,
                "hostname": "db-prod-01"
            },
            "credential": {
                "id": 101,
                "username": "svc-payments"
            }
        },
        {
            "id": "788",
            "session": {
                "session_id": "S2026082911980",
                "session_type": "epm",
                "protocol": null,
                "status": "terminated",
                "user": "jsilva",
                "justification": null,
                "access_period": "2026-08-29T09:00:00+00:00/2026-08-29T11:00:00+00:00",
                "origin": "200.100.50.51",
                "selection_mode": "automatic",
                "created_at": "2026-08-29T09:58:10+00:00",
                "started_at": "2026-08-29T10:01:44+00:00",
                "ended_at": "2026-08-29T10:29:12+00:00",
                "duration": "00:27:28"
            },
            "device": {
                "id": 61,
                "hostname": "ws-finance-04"
            },
            "credential": null
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "limit": 50,
            "total_items": 1250,
            "total_pages": 25
        },
        "links": {
            "self": "/api/v2/pam/sessions?session.status=active&page=1&limit=50",
            "next": "/api/v2/pam/sessions?session.status=active&page=2&limit=50"
        }
    }
}

Campos do corpo da resposta

data

data.session

data.device

data.credential

meta

Erros

Para as mensagens de erro de autenticação e a política de 403 versus 404, consulte API v2 - Convenções e comportamentos compartilhados.

Documentos relacionados

• API v2 - Convenções e comportamentos compartilhados
• GET | Listar uma sessão remota por [id]
• GET | Listar todas as sessões remotas
• Como gerenciar autorizações no A2A para a API v2