Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-lgpd-encryption-keys
saas-lgpd-encryption-keys
UnverifiedConfigure envelope encryption, KMS rotation, field-level PII protection, and crypto-shredding.
Running this workflow on this client
Run commands from the project root (use Git Bash on Windows if bash points to an unavailable WSL distro). Shared studio files live in .claude/; follow .agents/PORTABLE-RUNTIME.md and .claude/docs/config-resolution.md for client tools, delegation, and approval rules.
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: 197k | 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 |