# Registos de auditoria

O registo de auditoria inviolável: o que é registado, como pesquisar e exportar, e como verificar uma exportação selada.

O registo de auditoria é o registo permanente da plataforma de todas as ações significativas. Cada entrada regista *o que aconteceu*, *quem o desencadeou*, *quem ou o que foi afetado* e *quando*, juntamente com o endereço IP de origem, a localização aproximada e o user agent. As entradas são apenas acrescentadas, nunca editadas nem eliminadas manualmente, e cada entrada selada é encadeada e assinada criptograficamente, para que um terceiro possa comprovar que um registo exportado não foi adulterado.

O registo encontra-se na Admin Console em **Registo de auditoria → Registos**.

## O que é registado

O registo abrange toda a amplitude da atividade da plataforma. Em termos gerais, as entradas enquadram-se nestas áreas:

- **Autenticação**: inícios de sessão bem-sucedidos e falhados, trocas de tokens de single sign-on, inícios de sessão federados (sociais/empresariais), autenticação silenciosa, step-up e reautenticação, fim de sessão e fim de sessão back-channel.
- **Autenticação multifator**: registo de fatores, verificações bem-sucedidas e falhadas, utilização de códigos de recuperação, remoção de fatores e reposições de MFA iniciadas por um administrador.
- **Ciclo de vida do utilizador**: criação de contas, convites, alterações de perfil, alterações de e-mail/telefone/nome de utilizador/palavra-passe, ativação/desativação/desbloqueio de contas e eliminação. Consulte [Ciclo de vida do utilizador](https://dts-identity.com/pt/docs/directories/user-lifecycle.md).
- **Autorização**: acesso a aplicações concedido e revogado, alterações de funções e de membros de grupos, concessões de administrador de organização e revisões de acesso.
- **Administração e configuração**: alterações a aplicações, diretórios, ligações, zonas de rede, workflows de aprovação, workflows de certificação, APIs e chaves de API, organizações e definições do sistema.
- **Incidentes de segurança**: tentativas com palavras-passe comprometidas, deteção de força bruta, acesso a partir de uma região proibida, início de sessão a partir de um novo dispositivo e violações de limites de taxa.
- **Eventos de dispositivos**: registo e remoção, comandos enviados ou colocados em fila para um dispositivo e transições online/offline do connector.
- **Eventos de sessão**: sessões terminadas pelo sistema, com o registo da duração total da sessão concluída.
- **Aprovisionamento**: operações de aprovisionamento SCIM de saída e respetivos resultados.
- **Aprovações**: criação e eventos do ciclo de vida de workflows de aprovação, bem como campanhas de certificação de acesso e decisões de revisão.
- **Personificação (impersonation)**: quando um administrador começa e deixa de agir em nome de outro utilizador ou organização.

A lista completa e detalhada, com gravidades, encontra-se em [Tipos de eventos de auditoria](https://dts-identity.com/pt/docs/reference/audit-event-types.md).

## O modelo de ator: quem fez o quê a quem

Cada entrada distingue o **titular** (quem ou o que é *objeto* do evento) do **ator** (quem o *desencadeou*). É isto que permite responder à pergunta "o que aconteceu ao utilizador X?" pesquisando pelo titular, vendo ainda assim quem agiu.

- Nas ações de **self-service** (um utilizador que altera a sua própria palavra-passe ou inicia sessão), o titular e o ator são a mesma pessoa.
- Nas ações de **administrador sobre utilizador** (um administrador que atribui uma função a alguém ou desativa uma conta), o titular é o utilizador afetado e o administrador que agiu é registado ao lado.
- Nas **alterações de sistema ou de objetos** (criar uma aplicação, editar uma política), o administrador que agiu é o utilizador da entrada e o objeto alterado é indicado na entrada.
- Nas ações **executadas por máquinas** através da API, o ator é registado como cliente (máquina) e não como pessoa, juntamente com o canal através do qual chegou (Admin Console, API, aprovisionamento, connector ou sistema).

A vista de detalhe de cada entrada mostra o objeto afetado, os campos alterados quando aplicável, o IP/localização/user agent e o contexto completo do evento.

## Pesquisar e filtrar

O registo abre com as entradas mais recentes e carrega as mais antigas à medida que se desloca na página. A barra de ferramentas acima da lista é a mesma das listas de utilizadores e de dispositivos:

- **Regras de filtro**: adicione uma regra por campo e combine-as: **Tipo de evento** (um ou mais tipos do catálogo), **Categoria** e **Gravidade** (grupos inteiros de tipos de uma só vez), **Carimbo de data/hora** (um intervalo de/até com hora, no seu próprio fuso horário; deixe um dos lados em branco para um intervalo aberto), **País** e **Cidade** (a partir da geolocalização da entrada), **Endereço IP**, **E-mail do utilizador**, **Nome de utilizador**, **Aplicação** e **Diretório** (seleção a partir da lista), **Organização** e **Descrição**. As regras de texto oferecem *contém*, *é igual a*, *começa com* e as respetivas negações; as regras de lista oferecem *é um de* / *não é nenhum de*.
- **Pesquisa de texto livre**: compara com a descrição, o endereço IP, o nome/nome de utilizador/e-mail do utilizador titular ou o nome da aplicação. Prima Enter para aplicar.
- **Colunas**: mostre ou oculte colunas e arraste-as para as ordenar. Além das colunas predefinidas de carimbo de data/hora, evento, aplicação e utilizador, estão disponíveis endereço IP, localização, gravidade, categoria, diretório e organização.
- **Vistas**: as vistas padrão à esquerda são filtros predefinidos: *Ataques* (força bruta, bloqueios, palavras-passe comprometidas, região proibida, localização invulgar), *Inícios de sessão falhados*, *Segurança e deteção de anomalias*, *Configuração e administração do sistema* e *Erros*. Guarde a sua própria combinação de regras e colunas como vista com nome, ou copie o URL: todos os filtros ficam na barra de endereço.
- **Exportar CSV**: transfere a lista filtrada pela ordem visível das colunas (menu de partilha), das mais recentes para as mais antigas e limitada a 50 000 entradas; a caixa de diálogo indica quando a vista contém mais, pelo que deve restringir o filtro para abranger tudo.

A lista funciona também **em tempo real**: ative o **Modo em tempo real** e as novas entradas surgem automaticamente à medida que acontecem, e o gráfico de atividade é atualizado, sem necessidade de recarregar a página. Isto é útil enquanto reproduz um problema ou acompanha o desenrolar de um incidente. O gráfico e o feed em tempo real seguem o filtro ativo.

Abra qualquer entrada para ver o respetivo painel de detalhe completo, incluindo o contexto bruto do evento.

Alguns exemplos práticos de combinação de filtros:

- **Todos os inícios de sessão falhados a partir de um IP num intervalo**: escolha a vista *Inícios de sessão falhados* e adicione uma regra **Carimbo de data/hora** com o intervalo e uma regra **Endereço IP**.
- **Tudo a partir de um país**: adicione uma regra **País** (por exemplo, depois de o mapa de ataques do painel de proteção mostrar uma origem inesperada); adicione **Carimbo de data/hora** para restringir ao dia em causa.
- **Todos os eventos de MFA de um utilizador**: adicione uma regra **Tipo de evento** com os eventos multifator e uma regra **E-mail do utilizador**.
- **Todas as alterações de configuração feitas por um administrador**: escolha a vista *Configuração e administração do sistema* e pesquise o nome do administrador.
- **Tudo o que aconteceu a um dispositivo**: abra o separador **Histórico** do dispositivo. Lista as entradas relativas a esse dispositivo (comandos, execuções de atualização, aprovação, utilizadores associados, violações de políticas), com pesquisa própria e filtros de tipo e de data; a lista de tipos mostra apenas os tipos que ocorrem no dispositivo. Abrange as entradas escritas desde a introdução do separador e é apresentado aos administradores que podem ler todo o registo de auditoria.

> **Nota:** Os segredos de utilização única transmitidos em links (tokens de reposição de palavra-passe, códigos de verificação de e-mail) são automaticamente ocultados das entradas do registo, pelo que nunca são guardados no registo de auditoria.

## Selagem inviolável

Além de só permitir acrescentar entradas, o registo de auditoria é **selado** para que qualquer adulteração possa ser detetada posteriormente:

1. **Cadeia de hashes.** Cada entrada selada recebe um número de sequência e um hash calculado sobre o conteúdo da entrada *e* o hash da entrada anterior (um HMAC cuja chave é um segredo específico da implementação). Como cada hash incorpora o anterior, alterar, remover ou reordenar qualquer entrada quebra a cadeia a partir desse ponto.
2. **Assinatura criptográfica.** Cada entrada selada é adicionalmente assinada com uma chave Ed25519. A **chave pública de verificação** correspondente é publicada, pelo que qualquer pessoa que a possua pode verificar uma assinatura sem acesso à plataforma.

A selagem decorre em segundo plano e nunca bloqueia nem descarta uma escrita no registo.

Não precisa de exportar para detetar um problema: assim que uma entrada é selada, a respetiva vista de detalhe mostra os metadados de selagem da entrada (número de sequência, hash, hash anterior) juntamente com um **indicador de validade do hash**. Um visto verde significa que o hash recalculado da entrada continua a corresponder; uma verificação falhada é assinalada diretamente na consola, pelo que um elo quebrado da cadeia fica visível no próprio local e não apenas no momento da exportação.

> **O que isto comprova e o que não comprova.** A selagem permite-lhe a si (ou a um auditor externo) pegar num lote **exportado** de entradas de registo e comprovar mais tarde que não foi alterado, reordenado ou truncado após a exportação, e que foi assinado por esta plataforma. Foi concebida para *exportar registos para outros locais e comprovar a integridade mais tarde*. Não constitui uma garantia de não repúdio perante o operador da plataforma.

### Verificar um registo exportado

Para verificar de forma independente uma exportação do registo:

1. **Exporte as entradas.** Obtenha as entradas do registo (através da API de registos da plataforma, que inclui os metadados de selagem, ou seja, número de sequência, hash anterior, hash e assinatura, juntamente com o conteúdo de cada entrada).
2. **Obtenha a chave pública de verificação.** A plataforma publica a chave pública Ed25519 utilizada para assinar as entradas; obtenha-a uma vez e guarde-a.
3. **Verifique.** A verificação percorre as entradas exportadas por ordem de sequência e executa três verificações em camadas:
   - uma **pré-análise estrutural** que confirma que os números de sequência são contíguos e que o hash anterior registado de cada entrada corresponde à entrada que a precede (não requer qualquer segredo);
   - um **recálculo do hash** que volta a derivar o hash de cadeia de cada entrada a partir do seu conteúdo e o compara com o valor guardado;
   - uma **verificação da assinatura** que verifica a assinatura Ed25519 de cada entrada com a chave pública publicada.

   Se as entradas tiverem sido alteradas, reordenadas ou se o final tiver sido cortado, uma destas verificações falha e indica exatamente onde.

A Admin Console apresenta a chave pública publicada e o topo atual da cadeia, para que possa confirmar uma exportação face ao registo ativo.

## Histórico de alterações por objeto

Separadamente do registo de auditoria central, alguns registos mantêm o seu **próprio histórico de alterações com versões**: um antes/depois ao nível dos campos que mostra como esse objeto evoluiu. Na página de detalhe de um utilizador, abra **Ver histórico** para ver cada versão com os campos adicionados, removidos ou alterados (valor antigo para valor novo) e quando.

Utilize-o quando a sua pergunta for *"como chegou este registo ao seu estado atual?"*: lê-se como uma cronologia de diferenças limpa para esse objeto. Utilize o registo de auditoria central quando a sua pergunta for *"quem fez o quê, em tudo, neste intervalo?"*. Os dois complementam-se: o registo de auditoria é o registo transversal; o histórico de alterações é a história de cada objeto.

## Retenção

O tempo durante o qual as entradas são conservadas depende do seu nível de subscrição:

| Nível | Retenção do registo de auditoria |
|---|---|
| Trial | 7 dias |
| Essential | 30 dias |
| Advanced | 90 dias |
| Pro | até 365 dias |

As entradas mais antigas são removidas automaticamente quando ultrapassam o período de retenção. Se precisar de conservar registos durante mais tempo do que o seu nível permite, exporte-os periodicamente: os lotes exportados e selados permanecem verificáveis indefinidamente. A matriz completa encontra-se em [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md).

## Exportação

As entradas podem ser exportadas através da API de registos da plataforma, para arquivo, ingestão num sistema a jusante ou verificação independente. A exportação inclui o conteúdo de cada entrada **e** os respetivos metadados de selagem, o que torna possível uma verificação de integridade posterior.

A exportação é feita **a pedido**: obtém as entradas quando precisa delas. Não existe um destino de streaming em tempo real: a plataforma não envia um feed contínuo para um coletor de registos externo. Se conservar registos num sistema externo, agende uma exportação periódica e **exporte sempre antes de as entradas saírem do período de retenção do seu nível** (consulte Retenção acima): uma vez removidas, deixam de constar do registo ativo, embora qualquer lote selado que já tenha exportado continue verificável.

## Relacionado

- [Tipos de eventos de auditoria](https://dts-identity.com/pt/docs/reference/audit-event-types.md): o catálogo completo dos eventos registados.
- [Problemas](https://dts-identity.com/pt/docs/monitoring/issues.md): anomalias recorrentes do sistema, acompanhadas separadamente.
- [Ciclo de vida do utilizador](https://dts-identity.com/pt/docs/directories/user-lifecycle.md): as alterações de estado do utilizador que aparecem no registo.
