> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md).

# Trilha de auditoria

O SONAR registra em Reports & Audits › Audits e na aba Audits do dispositivo logins, alterações, comandos, scripts, sessões remotas e ações em massa, com filtros, exportação e retenção.

## O que é e quando usar

A trilha de auditoria é a lista das ações que as pessoas executam pelo console e pela API: quem entrou, quem alterou qual objeto, quem executou um comando ou um script em qual dispositivo, quem abriu uma sessão remota, quem disparou uma ação em massa. Cada registro guarda o usuário, o horário, o endereço de origem, uma mensagem e, nas alterações de objetos, os valores de antes e de depois da alteração.

Use-a para responder a uma pergunta sobre o passado: quem removeu aquele dispositivo, quem alterou o modelo de alerta padrão, quais scripts rodaram em `WS-0001` na semana passada, quem não conseguiu entrar hoje de manhã.

Os mesmos registros aparecem em dois lugares:

| Onde                            | O que mostra                                                             |
| ------------------------------- | ------------------------------------------------------------------------ |
| **Reports & Audits › Audits**   | A trilha inteira, com filtros de escopo, usuário, ação, objeto e período |
| A aba **Audits** do dispositivo | Apenas os registros gravados para esse dispositivo                       |

## Antes de começar

* O seu papel precisa de **View Audit Logs** (grupo **Logs** em **Admin Center › Roles**). Sem essa permissão, **Audits** não aparece no menu e a aba **Audits** do dispositivo não retorna dados. Veja [Papéis e permissões](https://wiki.datadike.com/pt/sonar/administration/identities/roles.md).
* Os registros mais antigos que o período de retenção de auditoria já não existem para ser encontrados. Confira primeiro **Admin Center › Settings › Retention**; veja [Retenção de dados](https://wiki.datadike.com/pt/sonar/administration/settings/retention.md).

## O que é registrado

| Ação                                                 | Registrada quando                                                                                                       | Mensagem típica                                                                        |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| **Login**                                            | Um usuário entra no console                                                                                             | `jdoe logged in successfully`                                                          |
| **Failed Login**                                     | Uma senha ou um código de dois fatores é recusado                                                                       | `jdoe failed to login: Credentials were rejected`, ou `...: Two Factor token rejected` |
| **Add Object**, **Modify Object**, **Delete Object** | Um usuário cria, altera ou exclui um objeto pelo console ou pela API                                                    | `jdoe modified client CLIENT-A`                                                        |
| **Agent Install**                                    | Um novo agente se registra no SONAR                                                                                     | Cita o novo dispositivo, por exemplo `... installed new agent WS-0001`                 |
| **Execute Command**                                  | Um comando é enviado a um dispositivo                                                                                   | `jdoe issued powershell command on WS-0001.`                                           |
| **Execute Script**                                   | Um script é executado em um dispositivo, ou testado                                                                     | `jdoe ran script: "Clear temp" on WS-0001`                                             |
| **Remote Session**                                   | Um usuário abre o acesso remoto a um dispositivo                                                                        | Cita o usuário e o dispositivo                                                         |
| **Bulk Action**                                      | Um comando, um script ou uma ação de atualização é executado em massa, ou dispositivos são movidos entre sites em massa | `jdoe executed bulk script: Clear temp on all agents within client: CLIENT-A`          |
| **URL Action**                                       | Uma ação de URL é executada contra um dispositivo, cliente ou site, ou uma ação de URL ou um webhook é testado          | Cita a URL e o alvo                                                                    |

As alterações de objetos abrangem dispositivos, clientes, sites, usuários, papéis, chaves de API, scripts, checks, tarefas automatizadas, políticas de automação, políticas de atualizações, modelos de alerta, as configurações em **Settings**, campos personalizados, entradas do repositório de chaves, ações de URL, webhooks e políticas de acesso. Uma alteração só é gravada quando um valor realmente mudou; salvar um formulário sem alterações não acrescenta nada.

Quando um dispositivo é removido, o motivo digitado na confirmação é acrescentado à mensagem de **Delete Object**.

As verificações de MFA reforçada (step-up) também são registradas. Elas aparecem com a ação **Mfa Stepup** ou **Failed Mfa Stepup**.

{% hint style="info" %}
A trilha registra o que as pessoas fazem. Os dados que os agentes informam por conta própria, como resultados de checks, inventário e listas de software, não são registros de auditoria. Eles ficam no dispositivo; veja [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md).
{% endhint %}

## Passos

### Pesquisar a trilha inteira

1. Abra **Reports & Audits › Audits**. A página abre em **Sonar Audits**, mostrando a última semana, dos registros mais recentes para os mais antigos.
2. Em **Scope**, escolha **Clients** ou **Agents** e depois selecione uma ou mais entradas na lista **Clients** ou **Agent**. Deixe as duas vazias para pesquisar tudo.
3. Em **User**, selecione um ou mais usuários em **Users**.
4. Em **Actions**, clique nos botões desejados: **Login**, **Failed Login**, **Add**, **Modify**, **Delete**, **Agent Install**. Um segundo clique desativa o botão.
5. Em **More Actions**, selecione outras ações em **Action**, como **Execute Command**, **Execute Script**, **Remote Session**, **Bulk Action** ou **URL Action**.
6. Em **Object**, selecione os tipos de objeto a manter, como **Client**, **User** ou **Core Settings**.
7. Em **Time Window**, escolha o período, de **Today** a **All Time**.
8. Clique em **Apply Filters**.
9. Clique em uma linha para abrir **Audit details** com os valores registrados.
10. Para exportar as linhas, clique no ícone de download (**Export**) acima da tabela.

### Revisar um dispositivo

1. Selecione o dispositivo na lista de dispositivos para abrir o painel dele.
2. Abra a aba **Audits**.
3. Refine com **Users**, **Action**, **Time** ou os botões de ação. A lista é atualizada assim que um filtro muda.
4. Clique em uma linha para abrir **Audit details**.

## O que você deve ver

Uma tabela de registros com o horário, o usuário, a ação como um selo colorido (verde para inclusões e instalações, amarelo para alterações, vermelho para exclusões e logins com falha, azul para o restante), o tipo de objeto, a mensagem e o endereço de origem. Nos registros gravados para um dispositivo, **Client** e **Site** mostram o cliente e o site a que esse dispositivo pertence.

Abaixo da tabela, um seletor define 25, 50, 100, 500 ou 1000 linhas por página, e **Page 1 of N**, com as setas, passa de uma página a outra.

**Audit details** abre à direita, com a mensagem como subtítulo e dois blocos, **Before** e **After**. Um registro **Add Object** tem apenas um valor em **After**, um registro **Delete Object** apenas um valor em **Before**, e um registro **Modify Object** tem os dois, para que você os compare campo a campo. Os registros sem nada a mostrar exibem **No data**. Nas políticas de acesso, os blocos exibem **Content restricted**; o histórico de alterações fica na **Audit Trail** da própria política (veja [Políticas de acesso](https://wiki.datadike.com/pt/sonar/administration/access/access-policies.md)).

A exportação é um arquivo CSV chamado `export.csv`, com as colunas da tabela. Ele contém as linhas da página carregada no momento.

## Como verificar se funcionou

1. Saia, entre uma vez com uma senha errada e depois entre corretamente.
2. Abra **Reports & Audits › Audits**, defina **Time Window** como **Today**, clique nos botões **Login** e **Failed Login** e depois em **Apply Filters**. As duas tentativas precisam aparecer com o seu nome de usuário, com o seu endereço em **Client IP**.
3. Altere um valor em **Admin Center › Settings › General**, por exemplo **Default date format**, e salve.
4. De volta a **Audits**, desative os botões de ação, selecione **Core Settings** em **Object** e aplique. Um registro **Modify Object** precisa aparecer; o **Audit details** dele mostra o valor antigo em **Before** e o novo em **After**.
5. Envie um comando inofensivo a um dispositivo de teste e depois abra a aba **Audits** desse dispositivo. Um registro **Execute Command** precisa estar no topo.

## Erros comuns

| Sintoma                                                                   | Causa                                                                            | Correção                                                                                                                           |
| ------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| O registro esperado não aparece                                           | O **Time Window** o exclui                                                       | Amplie o período, até **All Time**                                                                                                 |
| O registro não aparece nem com **All Time**                               | Ele é mais antigo que o período de retenção de auditoria                         | Os registros além do período são excluídos; aumente **Audit Logs (days)** em **Admin Center › Settings › Retention** para o futuro |
| Logins e alterações de configuração somem quando um cliente é selecionado | **Clients** e **Agent** só correspondem a registros gravados para um dispositivo | Esvazie a lista **Clients** ou **Agent** e aplique de novo                                                                         |
| **Audits** não aparece no menu                                            | O papel não tem **View Audit Logs**                                              | Conceda essa permissão em **Admin Center › Roles**                                                                                 |
| A exportação tem menos linhas que o total                                 | A exportação pega a página carregada no momento                                  | Defina 1000 linhas por página e exporte cada página                                                                                |
| Nada é registrado para dados que um agente enviou                         | A trilha registra ações de usuários e de chaves de API                           | Confira as próprias abas do dispositivo                                                                                            |

## Referência de campos

### Filtros

| Filtro                    | O que faz                                                                | Valores                                                                                                                                                     | Padrão             |
| ------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Scope**                 | Escolhe se você restringe por cliente ou por dispositivo                 | **Clients**, **Agents**                                                                                                                                     | **Clients**        |
| **Clients**               | Mantém os registros gravados para dispositivos dos clientes selecionados | Um ou mais clientes                                                                                                                                         | Vazio (todos)      |
| **Agent**                 | Mantém os registros gravados para os dispositivos selecionados           | Um ou mais dispositivos                                                                                                                                     | Vazio (todos)      |
| **Users**                 | Mantém os registros feitos pelos usuários selecionados                   | Um ou mais usuários                                                                                                                                         | Vazio (todos)      |
| Botões **Actions**        | Seleção rápida das ações mais comuns                                     | **Login**, **Failed Login**, **Add**, **Modify**, **Delete**, **Agent Install**                                                                             | Nenhum selecionado |
| **Action** (More Actions) | A lista completa de ações, combinada com os botões                       | Login, Failed Login, Add Object, Modify Object, Delete Object, Agent Install, Bulk Action, Execute Command, Execute Script, Remote Session, URL Action      | Vazio (todas)      |
| **Object**                | Mantém os registros sobre os tipos de objeto selecionados                | Agent, Automated Task, Bulk Actions, Core Settings, Check, Client, Policy, Site, Script, User, Patch Policy, Alert Template, Role, URL Action, Custom Field | Vazio (todos)      |
| **Time**                  | Período abrangido                                                        | **Today**, **Last 3 Days**, **Last Week**, **Last 2 Weeks**, **Last Month**, **Last 3 Months**, **Last 6 Months**, **Last Year**, **All Time**              | **Last Week**      |

Na aba **Audits** de um dispositivo, **Scope** e **Object** não aparecem: o dispositivo é o escopo.

### Colunas

| Coluna               | O que contém                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------- |
| **Time**             | Quando a ação aconteceu, no seu formato de data                                             |
| **Username**         | Quem a executou. Em uma falha de login, o nome de usuário que foi digitado                  |
| **Action**           | O tipo de ação                                                                              |
| **Object**           | O tipo de objeto envolvido                                                                  |
| **Message**          | Uma frase que descreve a ação, com o nome do objeto ou do dispositivo                       |
| **Client IP**        | O endereço de onde veio a solicitação, quando foi registrado                                |
| **Client**, **Site** | O cliente e o site a que o dispositivo pertence, nos registros gravados para um dispositivo |

## Páginas relacionadas

* [Relatórios](https://wiki.datadike.com/pt/sonar/administration/audit/reports.md): gerar documentos a partir dos dados do SONAR
* [Retenção de dados](https://wiki.datadike.com/pt/sonar/administration/settings/retention.md): por quanto tempo os registros de auditoria são mantidos
* [Papéis e permissões](https://wiki.datadike.com/pt/sonar/administration/identities/roles.md): como conceder **View Audit Logs**
* [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md): o painel do dispositivo e as abas dele
* [Políticas de acesso](https://wiki.datadike.com/pt/sonar/administration/access/access-policies.md): a trilha de auditoria da própria política
