skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
goul4rt/lgpd-skills74 installs

lgpd-audit-logging

Design and implement tamper-evident, transactionally serialized audit logging as a recommended engineering control for LGPD accountability (Art. 6, X) and security (Art. 46). Outputs Prisma schema, concurrency-safe hash-chain writer, DB write-protection triggers, and external WORM/SIEM anchoring verification.

How do I install this agent skill?

npx skills add https://github.com/goul4rt/lgpd-skills --skill lgpd-audit-logging
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides a high-quality, security-focused implementation for tamper-evident audit logging consistent with LGPD requirements. It correctly utilizes cryptographic hash chains, SHA-256 payload hashing, and PostgreSQL transactional advisory locks to prevent race conditions and ensure log integrity. No malicious patterns or security risks were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Audit Logging — Trilha de Auditoria Tamper-Evident

Controle de engenharia voltado a sustentar responsabilização e prestação de contas (Art. 6º, X) e segurança da informação (Art. 46).

Distinção normativa importante:

  1. A LGPD não exige expressamente o uso de hash chain. A lei exige medidas técnicas e administrativas aptas a proteger os dados (Art. 46) e demonstração de eficácia (Art. 6º, X). O encadeamento criptográfico (hash chain) é classificado aqui como controle técnico recomendado para detecção de adulteração (tamper-evidence), não como imposição literal do texto legal.
  2. Prazo de retenção: o prazo legal mínimo de 5 anos do Art. 10 da Resolução CD/ANPD nº 15/2024 refere-se especificamente ao registro de incidentes de segurança com dados pessoais. Para logs operacionais de auditoria (acessos administrativos, exportações, DSAR, consentimento), defina retenção proporcional aos prazos prescricionais e de fiscalização aplicáveis (ex.: 6 meses mínimos do Art. 15 do Marco Civil para logs de acesso a aplicações; 3 a 5 anos para trilhas probatórias de DSAR/consentimento sob Art. 6º, X e Res. 4/2023).

Por que uma hash chain sozinha NÃO é imutável

Uma cadeia de hashes armazenada apenas na mesma tabela PostgreSQL detecta edições pontuais ingênuas, mas sofre duas falhas clássicas se mal implementada:

  1. Condição de corrida (race condition): duas requisições paralelas que leem o último hash fora de uma transação serializada gravam o mesmo prevHash, bifurcando e quebrando a cadeia em produção.
  2. Reescrita privilegiada: um invasor ou administrador malicioso com permissão de UPDATE/DELETE no banco pode alterar um registro antigo e recalcular todos os hashes subsequentes em segundos.

Para que a trilha seja confiável de verdade, combine quatro camadas:

  1. Serialização transacional + sequência monotônica (seq BigInt): use pg_advisory_xact_lock dentro de db.$transaction(...) e ordene por seq (nunca apenas por timestamp, que pode empatar no mesmo milissegundo).
  2. Restrição de privilégios e triggers no PostgreSQL: a role da aplicação deve ter apenas SELECT, INSERT (REVOKE UPDATE, DELETE, TRUNCATE) + trigger bloqueando mutações.
  3. Mapeamento explícito de colunas: nunca faça spread (...entry) repassando objetos Request ou payloads brutos para o Prisma, e extraia apenas o primeiro IP válido de x-forwarded-for para não quebrar colunas @db.Inet.
  4. Ancoragem externa periódica (WORM / SIEM): publique periodicamente (ex.: a cada hora/dia) o par (seq, selfHash) mais recente em destino externo imutável (S3 Object Lock em modo Compliance, CloudWatch Logs / GCP Cloud Logging em conta segregada) e valide-o em verifyAuditChain().

Artefatos de referência prontos e testados

Uso recomendado em rotas críticas

import { logAudit, verifyAuditChain } from "@/lib/privacy/audit-log";

await logAudit(prisma, {
  actorId: session.user.id,
  actorType: "USER",
  action: "DSAR_EXPORT_COMPLETED",
  resource: `User:${session.user.id}`,
  subjectId: session.user.id,
  legalBasis: "ART_18_II",
  purpose: "subject_data_export",
  // NUNCA passe PII em claro — apenas metadados redigidos ou hashes
  redactedMetadata: { format: "json", bundleSha256: bundleHash },
  req,
});

Eventos prioritários para registrar (sem PII em claro)

  • Autenticação administrativa, elevação de privilégio e mudanças de RBAC
  • Leitura/exportação administrativa de dados pessoais ou sensíveis de terceiros
  • Operações do ledger de consentimento (GRANTED, REVOKED, SUPERSEDED)
  • Ciclo completo de DSAR (recebimento, verificação proporcional de identidade, atendimento, eventual recusa fundamentada)
  • Execução de jobs de retenção, anonimização e crypto-shredding

Proteção de banco + Ancoragem externa

  1. Aplique na tabela "AuditLogEntry" a mesma trigger de bloqueio de UPDATE, DELETE e TRUNCATE (ver lgpd-consent-schema/assets/consent-append-only.sql) e revogue permissões destrutivas da role de aplicação.
  2. Agende job diário que:
    • Executa verifyAuditChain(entries, lastExternalAnchor);
    • Grava o novo (seq, selfHash) em bucket S3 Object Lock (WORM) ou SIEM segregado;
    • Dispara alerta imediato para Segurança e Encarregado em caso de divergência.

Status update

## F8 / L8b — Audit logging ✓
- Modelo `AuditLogEntry` com `seq` monotônico validado
- `logAudit()` serializado com `pg_advisory_xact_lock` e sanitização de IP
- Trigger append-only + revogação de `UPDATE/DELETE` configurados
- Verificação periódica `verifyAuditChain()` + âncora externa configuradas

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/goul4rt/lgpd-skills/lgpd-audit-logging">View lgpd-audit-logging on skillZs</a>