Saltar al contenido principal

TEC-019 — Cifrado de datos sensibles (PII) y endurecimiento del JWT

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Primera fase del requerimiento REQ-SEC-14 (Seguridad), que nace de su validación: el cifrado en reposo de TEC-007 cubría importes y proveedor, pero no la PII de personas. La Fase 1 la cifra, añade el secreto de webhook a la rotación y fija el algoritmo del JWT. La Fase 2 (sesión en cookie HttpOnly + CSRF) queda documentada para después.


📋 Alcance (Fase 1)​

RFEntregable
RF-TEC-019-01Cifrado de usuarios.numero_documento/telefono/genero y firmas_documento.numero_documento_firmante/firma_imagen
RF-TEC-019-02config_webhooks.secreto_cifrado entra en el inventario de rotación
RF-TEC-019-04Algoritmo de firma del JWT fijado en HS256

🔐 Cómo se cifra la PII​

  • Se reutiliza el ValueTransformer de TEC-007 (AES-256-GCM, clave centralizada con rotación).
  • numero_documento era UNIQUE y se busca por igualdad: como el ciphertext cambia en cada escritura, se añade un índice ciego (numero_documento_hash, HMAC-SHA256 determinista) que conserva la unicidad y permite buscar sin descifrar la tabla.
  • firma_imagen (bytea) se cifra con un transformer binario nuevo: Buffer → base64 → cifrado en una columna text; el PDF sigue recibiendo el Buffer.
  • No se cifran email ni nombre (romperían login, unicidad y búsquedas).
usuarios.numero_documento : "1000000001" → "v1:iv:tag:cifrado" (+ huella HMAC en numero_documento_hash)

⚙️ Migración y puesta en marcha​

  • Migración 040-cifrar-pii-usuarios-firmas.ts: solo cambia el esquema (retira el UNIQUE del documento, pasa las columnas a text, añade la huella con UNIQUE).
  • npm run cifrado:rotar: nuevo paso 0 que puebla la huella leyendo el documento aún en claro y después cifra los heredados.

🖥️ JWT​

auth.module.ts fija signOptions.algorithm = 'HS256' y jwt.strategy.ts acepta solo ['HS256'].

🧪 Verificación​

PruebaResultado
npx tsc --noEmitCompila (solo errores de un spec ajeno: req-sec-12)
Subconjunto cifrado + usuarios + firmas91/91 verde
Suite completa1127/1130 (los 3 fallos son de req-ava-03, ajeno)

🚧 Fase 2 (pendiente)​

Sesión en cookie HttpOnly; Secure; SameSite + CSRF (web), expo-secure-store (móvil) y minimización de la PII del payload del JWT con un endpoint /me.

📎 Documentación​