Backend · Segurança

Log de Auditoria Encadeado

Trilha de auditoria append-only com cadeia de hashes SHA-256 (ou HMAC): qualquer edição ou remoção é detectada. Prova técnica pra LGPD, compliance e disputa com cliente.

Auditoria · Hash chain · Compliance · 9 testes automatizados · Licença MIT · Criado por FlowCore Soluções LTDA

Como instalar

  1. Funciona onde você já roda Node 18+, Cloudflare Workers, Deno, Bun, Vercel e Netlify Functions. Zero dependência: só fetch e Web Crypto, que já vêm no runtime.
  2. Crie src/lib/log-auditoria.ts Cole o código da aba Código.
  3. Use
    const auditoria = criarLogAuditoria({ armazem: meuArmazemPostgres, chaveHmac: env.AUDIT_KEY });
await auditoria.registrar({ ator: "u_42", acao: "pedido.cancelado", recurso: "pedido:981", dados: { motivo } });
const r = await auditoria.verificar();
if (!r.valido) alertar(`Log adulterado na linha ${r.seq}`);
  4. Rode o teste junto O arquivo de teste (aba Teste) cobre 9 cenários. Copie para src/lib/ ao lado e rode:
    npm install -D vitest
npx vitest run src/lib

Código no GitHub · Biblioteca de códigos

Mais em Segurança