Registo de Auditoria

O registo de auditoria regista todas as ações significativas realizadas na sua conta Aether365.

O que e Registado

Cada entrada tem um action id, um actor humano (email quando disponível, caso contrário user) e um payload JSON details.

Categoria	Action id	Notas
Conta	profile.updated	Alteração de nome completo / nome da empresa
	account.self_deleted	Eliminação self-service da conta
Análises	scan.started	Acionamento manual ou agendado
	scan.completed / scan.failed / scan.cancelled	Estado final da análise
	scheduled_scan.created / .updated / .deleted	Gestão de análises agendadas
Ligações Microsoft	tenant.connected / tenant.disconnected	Primeiro consentimento administrativo
	connection.activated	Definido como ligação principal
	connection.removed	Desligar uma ligação individual
	connection.label_updated	Renomear uma ligação guardada
Equipa	member.invited / member.removed	Gestão de equipa por tenant
Notificações	notifications.updated	Canais de email + Teams
Acesso API	api_key.created / api_key.revoked	Funcionalidade Enterprise
SSO / SAML	sso.configured / sso.deleted	Funcionalidade Enterprise
Retenção de registos	retention.updated	Funcionalidade Enterprise
Faturação	billing.checkout.started	Sessão de Stripe Checkout criada
	subscription.created / subscription.updated / subscription.deleted	Eventos webhook do Stripe
	invoice.payment_succeeded / invoice.payment_failed	Eventos webhook do Stripe
Suporte	support.ticket.created / support.ticket.replied	Atividade de help-desk

Visualizar o Registo de Auditoria

Para aceder ao registo de auditoria:

1. Va a Definições na barra lateral
2. Abra o separador Registo de Auditoria

O registo de auditoria mostra as 500 entradas mais recentes. As entradas são ordenadas da mais recente para a mais antiga.

Filtragem

A página de auditoria tem quatro filtros no topo:

• Evento - lista suspensa com todas as ações que o seu tenant já registou.
• Ator - correspondência de substring insensível a maiúsculas na coluna de email.
• De / Até - seletores de calendário (o valor até e tratado como fim do dia na hora local).

A linha de filtro redefine a paginação para a página 1 sempre que altera um valor, e uma ligação Limpar filtros aparece assim que qualquer filtro está ativo.

Exportar o Registo de Auditoria

Para exportar o registo de auditoria como CSV:

1. Abra Definições > Registo de Auditoria.
2. Aplique os filtros que pretender.
3. Clique em Exportar CSV no canto superior direito.

A exportação percorre a API em páginas de 1000 linhas com os filtros ativos aplicados e descarrega um CSV UTF-8 com o nome aether365-audit-YYYY-MM-DD.csv. Colunas: Time, Event (rótulo legível), Action ID, Actor, Details (JSON).

Registo de Auditoria via API

O registo de auditoria está acessível através da API REST:

curl https://api.aether365.io/tenants/me/audit-logs \
  -H "Authorization: Bearer <token>"

Parâmetros de consulta:

Parâmetro	Tipo	Descrição
page	integer	Número da página (predefinido 1)
limit	integer	Resultados por página (máximo 1000)
action	string	Correspondência exata no action id
actor	string	Correspondência de substring insensível a maiúsculas no ator
from	string	Timestamp ISO 8601 - limite inferior (inclusivo)
to	string	Timestamp ISO 8601 - limite superior (inclusivo)

Exemplo de Resposta

{
  "success": true,
  "data": [
    {
      "id": "f4b1c7d2-...",
      "action": "scan.started",
      "actor": "alice@example.com",
      "details": {
        "scanId": "8d3e1f...",
        "scanType": "compliance"
      },
      "createdAt": "2026-04-10T09:15:00Z"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "limit": 50,
    "actions": ["api_key.created", "scan.started", "support.ticket.created"]
  }
}

meta.actions lista os action ids distintos que o seu tenant utilizou - a interface utiliza-os para preencher a lista suspensa Evento.

Retenção

As entradas do registo de auditoria são retidas pelo mesmo período que os dados de análise. Se necessitar de retenção mais longa do registo de auditoria por razões de conformidade, contacte support@aether365.io para discutir uma opção de retenção prolongada.