Skip to content

Basinfy/Basinfy-SaaS-Studio / .claude/skills/saas-lgpd-encryption-keys

saas-lgpd-encryption-keys

Verified

Configure envelope encryption, KMS rotation, field-level PII protection, and crypto-shredding.

FileKindSize
SKILL.mdskill md4.3 KB
---
name: saas-lgpd-encryption-keys
description: "Configure envelope encryption, KMS rotation, field-level PII protection, and crypto-shredding."
argument-hint: "[scope or artifact path]"
user-invocable: true
allowed-tools: Read, Glob, Grep, AskUserQuestion, mcp__basinfy__basinfy_query_script, mcp__basinfy__basinfy_discover, mcp__basinfy__basinfy_prepare_edit, mcp__basinfy__basinfy_prepare_create, mcp__basinfy__basinfy_impact, mcp__basinfy__basinfy_remember, mcp__basinfy__basinfy_recall, Bash(basinfy *)
model: sonnet
---

# Encryption & Key Management

> **Locale & User Profile**: Match `locale` (`pt-BR` → natural Brazilian Portuguese questions/options, overriding English examples; `en` → English) and `user_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-pinning` ou 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:

```ts
// 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:
```ts
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

```markdown
## 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
```

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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall