Basinfy/Basinfy-SaaS-Studio / .claude/skills/saas-lgpd-encryption-keys
saas-lgpd-encryption-keys
VerifiedConfigure envelope encryption, KMS rotation, field-level PII protection, and crypto-shredding.
Encryption & Key Management
Locale & User Profile: Match
locale(pt-BR→ natural Brazilian Portuguese questions/options, overriding English examples;en→ English) anduser_profile(founder→ plain business language with(Recomendado)first, zero tech jargon;developer→ technical). Keep code/tests in English.
Art. 46 LGPD + Guia de Segurança da Informação para ATPP (ANPD, 2021).
Camadas
1. Em trânsito
- TLS 1.3 em toda comunicação (cliente ↔ servidor, serviço ↔ serviço)
- HSTS habilitado (
max-age=31536000; includeSubDomains; preload) - Certificate pinning em apps mobile (React Native —
react-native-ssl-pinningou equivalente) - mTLS para comunicação entre serviços internos quando viável
2. Em repouso
- TDE (Transparent Data Encryption) no PostgreSQL — habilitado pelo provider (AWS RDS, GCP Cloud SQL)
- Volume encryption (EBS, persistent disks) — geralmente padrão hoje
- Backups criptografados — mesma chave do volume, ou KMS dedicado
- Storage de arquivos (S3, GCS): server-side encryption (SSE-KMS preferível a SSE-S3)
3. Nível de aplicação (campos sensíveis)
Para CPF, biometria, dados de saúde, tokens de auth — criptografia adicional em coluna:
// lib/crypto/field-encryption.ts
import { createCipheriv, createDecipheriv, randomBytes } from "crypto";
const KEY = await loadKeyFromKMS(); // 32 bytes
export function encryptField(plain: string): string {
const iv = randomBytes(12);
const cipher = createCipheriv("aes-256-gcm", KEY, iv);
const enc = Buffer.concat([cipher.update(plain, "utf8"), cipher.final()]);
const tag = cipher.getAuthTag();
return Buffer.concat([iv, tag, enc]).toString("base64");
}
export function decryptField(encoded: string): string {
const buf = Buffer.from(encoded, "base64");
const iv = buf.subarray(0, 12);
const tag = buf.subarray(12, 28);
const enc = buf.subarray(28);
const decipher = createDecipheriv("aes-256-gcm", KEY, iv);
decipher.setAuthTag(tag);
return Buffer.concat([decipher.update(enc), decipher.final()]).toString("utf8");
}
Prisma extension para criptografia transparente:
const prisma = new PrismaClient().$extends({
query: {
user: {
async create({ args, query }) {
if (args.data.cpf) args.data.cpf = encryptField(args.data.cpf);
return query(args);
},
async findUnique({ args, query }) {
const r = await query(args);
if (r?.cpf) r.cpf = decryptField(r.cpf);
return r;
}
}
}
});
KMS
Use KMS gerenciado (AWS KMS, GCP KMS, Azure Key Vault) ou HashiCorp Vault para chaves de aplicação.
- Chaves separadas por finalidade (PII identidade vs. PII financeiro vs. PII saúde)
- Rotação anual no mínimo (data key automática + master key manual)
- Acesso por IAM com least privilege
- Log de uso da chave (CloudTrail / equivalente)
- Backup das chaves (KMS já faz, mas atestar)
Crypto-shredding
Para suportar Art. 18, VI (eliminação):
- Cada titular tem uma chave de envelope (encrypted by master key)
- Dados sensíveis cifrados com a chave do titular
- Eliminação = deletar a chave do titular no KMS
- Dado em repouso torna-se irrecuperável sem necessidade de varrer 100% do storage
Útil quando há retenção legal de outros campos mas o restante deve ser eliminável.
Better Auth + senhas
Better Auth usa hash padrão (Argon2id ou bcrypt). Configure:
- Argon2id com memória ≥ 64MB, paralelismo 2, iterações ≥ 3
- OU bcrypt com cost ≥ 12
Status update
## F7 — Encryption ✓
- TLS 1.3 + HSTS confirmados
- TDE habilitado no Postgres
- KMS configurado com 3 chaves (identidade, financeiro, saúde)
- Crypto-shredding implementado para campos críticos
- Rotação anual em calendário
- Próximo: saas-lgpd-retention-erasure
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |