Registro de Auditoria e Monitoramento

​

Arquitetura do Log de Auditoria

​

Schema

CREATE TABLE audit_logs (
  id            uuid PRIMARY KEY DEFAULT gen_random_uuid(),
  workspace_id  uuid NOT NULL REFERENCES workspaces(id),
  actor_user_id uuid REFERENCES auth.users(id),  -- nulo para ações iniciadas pelo sistema
  entity_type   text NOT NULL,  -- ex.: 'contact', 'workspace_member', 'api_key', 'secret'
  entity_id     text NOT NULL,  -- ID da entidade afetada
  action        text NOT NULL,  -- ex.: 'gdpr_erasure', 'member_removed', 'secret_updated'
  metadata      jsonb,          -- contexto específico da ação (higienizado, sem valores de PII)
  created_at    timestamptz NOT NULL DEFAULT now()
);

​

O que é Registrado

​

Atualmente Implementado

​

Gravando uma Entrada de Log de Auditoria

await writeAuditLog({
  workspaceId: string,
  actorUserId: string | null,
  entityType: 'contact' | 'workspace_member' | 'api_key' | 'secret' | 'channel_settings' | 'consent' | 'account_alert',
  entityId: string,
  action: string,
  metadata?: Record<string, unknown>, // nunca inclua valores brutos de PII
});

​

Melhorias Planejadas no Log de Auditoria

​

Registro de Acesso de Leitura (BORD-168)

​

Cadeia de Hash à Prova de Adulteração (BORD-168)

entry_n.hash = SHA256(entry_(n-1).hash || entry_n.data)

​

Exportação Imutável para Object Storage (BORD-168)

​

Stack de Observabilidade

​

Monitoramento de Erros: Sentry

• Exceções não tratadas nas rotas de API
• Falhas de jobs do worker
• Erros de JavaScript no frontend

​

Agregação de Logs: Better Stack

​

Monitoramento de Saúde

​

Alertas de Conta (BORD-189)

• Alertas de saúde da API do WhatsApp — notificações quando a API da Meta retorna taxas de erro elevadas, respostas de limitação de taxa, ou falhas de entrega de webhook para os números de telefone do workspace
• Alertas de expiração de segredo — avisos quando tokens ou chaves de API armazenados no Vault estão se aproximando da expiração
• Alertas de limite de consentimento — notificações quando a taxa de opt-out de um workspace excede um limite configurável, indicando risco potencial de conformidade
• Alertas de anomalia de uso — sinalizações para picos inusuais de volume de mensagens, operações em massa de contatos ou padrões de uso de chave de API

​

Planejado: Detecção de Incidentes de Segurança (BORD-166)

• Detecção de anomalias: sinalizar padrões inusuais, como exportações em massa de contatos, alto volume de uso de chave de API ou acesso a partir de faixas de IP inesperadas
• Monitoramento de eventos de segurança: alertas dedicados para eventos relevantes à segurança (picos de falhas de autenticação, anomalias de sessões concorrentes, tentativas de escalonamento de privilégio)
• Integração de alertas: alertas baseados em webhook para Slack, PagerDuty ou endpoints configurados pelo operador

​

Planejado: Fluxo de Notificação de Violação de Dados (BORD-166)

1. Gatilhos de detecção de incidentes que criam um registro de incidente com o timestamp da detecção
2. Fluxo de avaliação de violação — perguntas guiadas para determinar o escopo da notificação
3. Geração de rascunho de notificação — templates pré-preenchidos para submissão à DPA
4. Contador regressivo de 72 horas — visível na UI de administração uma vez declarado um incidente
5. Delimitação de workspaces e contatos afetados — identificar quais dados de contatos podem ter sido envolvidos

​

Retenção dos Logs de Auditoria

​

Mapeamento de Conformidade