GET | Listar a trilha de auditoria de uma credencial

Descrição

Recupere todos os eventos registrados de uma credencial no PAM Core, utilizando o modelo canônico v2. A resposta agrega sessões, rotações, liberações de custódia e alterações de configuração em uma única lista cronológica.

O endpoint responde a uma única pergunta: o que aconteceu com esta credencial. Sem ele, o auditor cruza manualmente os recursos de sessões, rotações e custódia.

Este endpoint faz parte da superfície da API v2 do A2A, introduzida na versão 4.2.13. Não existe equivalente v1. A API v1 nunca expôs uma trilha de auditoria por credencial como recurso de primeira classe.

Pré-requisitos

Este endpoint utiliza a mesma autorização do A2A usada por GET /api/v2/pam/credentials. Nessa autorização, o administrador precisa habilitar:

• PAM Core como recurso autorizado, com permissão de leitura.
• Credentials and devices.
• PAM sessions (V2).

Para mais informações, acesse Como gerenciar autorizações no A2A.

Requisição

GET /api/v2/pam/credentials/{id}/audit-trail

Parâmetros de path

Parâmetros de query

Todos os parâmetros de query são opcionais.

Intervalo de datas

Ordenação

sort_by aceita um campo no formato field:asc ou field:desc. A direção padrão é asc. Exemplo: sort_by=occurred_at:desc.

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

Paginação

limit define o número máximo de eventos retornados.

Este endpoint segue o modelo de paginação compartilhado pela superfície da API v2. Para as regras completas, consulte API v2 - Convenções e comportamentos compartilhados.

Exemplo de requisição

GET {{url}}/api/v2/pam/credentials/102/audit-trail?limit=4&sort_by=occurred_at:desc

Resposta

HTTP/1.1 200 OK

Exemplo de corpo da resposta

{
    "data": [
        {
            "id": "coss_sessao:385",
            "occurred_at": "2026-08-25T15:19:57-03:00",
            "event_type": "session_start",
            "actor": {
                "id": 134,
                "username": "_a2a_alice",
                "name": "alice"
            },
            "outcome": "permitted",
            "details": {},
            "links": {
                "session": "/api/v2/pam/sessions/399"
            }
        },
        {
            "id": "coat_trail:2638",
            "occurred_at": "2026-08-25T15:18:11-03:00",
            "event_type": "rotation",
            "actor": {
                "id": 134,
                "username": "_a2a_alice",
                "name": "alice"
            },
            "outcome": "succeeded",
            "details": {
                "attempts": 1
            },
            "links": {
                "job": "/api/v2/pam/jobs/45"
            }
        },
        {
            "id": "coac_log:642",
            "occurred_at": "2026-08-25T15:17:03-03:00",
            "event_type": "configuration_change",
            "actor": {
                "id": 134,
                "username": "_a2a_alice",
                "name": "alice"
            },
            "outcome": "succeeded",
            "details": {
                "action": "Credential rotation requested",
                "origin": "PAM API",
                "changed": true
            }
        },
        {
            "id": "coac_log:640",
            "occurred_at": "2026-08-25T14:02:44-03:00",
            "event_type": "password_view",
            "actor": {
                "id": 134,
                "username": "_a2a_alice",
                "name": "alice"
            },
            "outcome": "denied",
            "details": {}
        }
    ],
    "meta": {}
}

Campos do corpo da resposta

Tipos de evento

A trilha agrega os seguintes tipos de evento.

Nota: As alterações de configuração não produzem um tipo de evento por ação. Criar, editar, ativar e desativar uma credencial chegam todos como configuration_change, e a ação realizada é descrita em details.action.

Details por tipo de evento

O objeto details muda de forma conforme o event_type.

rotation

configuration_change

Erros

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

Documentos relacionados

• API v2 - Convenções e comportamentos compartilhados
• GET | Listar uma credencial por id (v2)
• GET | Listar todas as credenciais (v2)
• Como gerenciar autorizações no A2A