Registos de auditoria

Consulte um histórico de ações que alteram o estado da sua organização, ao qual só é possível acrescentar entradas e que permite detetar adulterações — quem fez o quê, quando e a partir de onde.

Os registos de auditoria apresentam uma cronologia pesquisável e filtrável das ações administrativas abrangidas na sua organização, incluindo a atribuição de funções, a edição de motores e a emissão de chaves de API. Consulte as limitações de cobertura. Estão disponíveis no plano Enterprise, juntamente com Funções e permissões.

Ao nível da base de dados, só é possível acrescentar entradas ao registo: a ligação da aplicação não pode atualizar, eliminar nem truncar linhas de auditoria. O que fica registado não pode ser alterado.

O que é registado #

Cada evento regista o autor, a ação, o alvo e o contexto HTTP em que o pedido foi recebido.

CampoNotas
AutorO utilizador ou a chave de API que executou a ação
AçãoUm valor tipado, como engine.created ou member.role_changed
AlvoA entidade afetada (por exemplo, um motor, uma função ou um item do glossário)
MetadadosIDs de entidades relacionadas — nunca nomes, endereços de e-mail ou excertos de conteúdo
Contexto do pedidorequest_id, endereço IP, agente do utilizador — registados quando a chamada foi recebida por HTTP
Data e horaUTC, com um número de sequência monotónico para detetar lacunas

Apenas IDs, por opção

A coluna de metadados guarda IDs, não valores legíveis por pessoas. A interface associa-os aos nomes atuais no momento da leitura, pelo que alterar o nome de um motor ou utilizador não reescreve o histórico. Isto também evita conflitos entre as linhas de auditoria e o direito ao apagamento previsto no RGPD — não há conteúdo a expurgar.

Ações abrangidas #

Os eventos são agrupados em categorias que correspondem ao filtro do painel.

CategoriaAções atualmente abrangidas
Organizaçãoorg.created, org.settings_updated, org.deleted
Membrosmember.invited, member.removed, member.role_changed
Funçõesrole.created, role.updated, role.deleted
Motoresengine.created, engine.updated, engine.deleted
Chaves de APIapi_key.created, api_key.revoked
Conteúdoglossary_item.*, instruction.*, brand_voice.* (apenas operações individuais)

Aceder ao registo #

A opção Registo de auditoria aparece sempre em Definições, na secção Administração. Sem o direito de acesso, a página apresenta "O registo de auditoria não está disponível no seu plano" em vez da cronologia. Na página, encontrará:

  • Lista filtrável — filtre por Ação, Autor e Período (um período predefinido, como Últimos 7 dias, ou um intervalo de datas De / Até). Não é possível selecionar datas futuras.
  • Carregar eventos mais antigos — os eventos mais recentes aparecem primeiro; clique em Carregar eventos mais antigos no final da lista para obter a página seguinte.
  • Detalhes do evento — clique em qualquer linha para a expandir no próprio local e ver todos os metadados, o ID do pedido, o IP e o agente do utilizador.
  • Vistas partilháveis — os filtros e o evento aberto refletem-se no URL, pelo que qualquer vista pode ser partilhada.

Quem pode consultar #

O acesso à página depende de duas condições:

  1. Direito de acesso — a funcionalidade de registos de auditoria tem de estar ativada para a organização (plano Enterprise).
  2. Permissão — a função de quem consulta tem de incluir org:view_audit_logs. A função Acesso total, criada de início, inclui esta permissão por predefinição; os Proprietários têm-na sempre.

Os membros sem a permissão veem uma página de "sem acesso" em vez da cronologia. Os membros de uma organização sem o direito de acesso veem uma página que exige a subscrição do plano.

Se o seu plano Enterprise expirar

Os registos de auditoria dependem do mesmo direito de acesso associado ao nível RBAC. Os eventos anteriores permanecem na base de dados, mas a página apresenta "O registo de auditoria não está disponível no seu plano" e os pontos de acesso de leitura devolvem 403 até o plano ser restabelecido.

Evidência de adulterações #

Os registos de auditoria não são apenas um histórico — são efetivamente difíceis de alterar depois de criados.

  • Só é possível acrescentar entradas ao nível da base de dados. A migração que instala a tabela executa REVOKE UPDATE, DELETE, TRUNCATE na função da API. Qualquer caminho de execução futuro — um erro, um novo ponto de acesso ou até uma injeção de SQL — é bloqueado pelo Postgres antes de poder alterar uma linha.
  • Sequência monotónica. Cada linha contém uma coluna seq com valores estritamente crescentes. Ao analisar a sequência, quem realiza a auditoria pode detetar eliminações através de lacunas.

Isto é suficiente para controlos do tipo SOC 2. Não protege contra um atacante com credenciais de acesso direto à base de dados de produção — estão disponíveis, mediante pedido, configurações de segurança mais robustas (função de proprietário separada, réplica WORM).

Retenção #

Por predefinição, os eventos de auditoria são conservados indefinidamente. No plano Enterprise, estão disponíveis períodos de retenção personalizados — normalmente de 1, 3 ou 7 anos. Contacte-nos se precisar de uma política de retenção específica para cumprir requisitos de conformidade ou responder a questionários de segurança.

O que não é abrangido #

Alguns limites definidos para a v1 que deve ter em conta:

  • Emissão na medida do possível, não transacional. A emissão transacional está prevista a curto prazo. O evento de auditoria é gravado após a ação que descreve — não na mesma transação da base de dados. Em situações raras de falha (uma ação é concluída com êxito, mas a inserção do registo de auditoria falha em seguida), a ação pode ocorrer sem um evento correspondente.
  • Alguns tipos de ação ainda não geram eventos. As alterações aos membros dos motores, a ligação / atualização / desativação de ligações de integrações, as edições da configuração de modelos, as alterações da subscrição de faturação e as operações de conteúdo em massa (carregamento de CSV, createMany / updateMany / deleteMany) ainda não produzem eventos. O vocabulário de ações já está reservado para que estas apareçam nas categorias de filtro existentes assim que o respetivo registo for implementado.
  • As leituras não são auditadas. Consultar o próprio registo de auditoria, navegar nos registos de pedidos do motor ou transferir um glossário não produz eventos. Só as ações que alteram o estado produzem eventos.
  • Ainda sem exportações. Os dados de auditoria são apresentados no painel. Estão previstos a exportação em CSV, um webhook SIEM e uma réplica S3 — diga-nos se precisar destas opções.
  • Sem vista por motor. Todos os eventos de auditoria da organização estão numa única cronologia. Filtre por ação ou autor para restringir os resultados.
  • Sem acompanhamento em tempo real. Não existe um botão Atualizar nem um fluxo WebSocket — recarregue a página para obter os eventos mais recentes.

Próximos passos #