TEC-019 — Cifrado de datos sensibles (PII) y endurecimiento del JWT
· 2 min de lectura
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)
| RF | Entregable |
|---|---|
| RF-TEC-019-01 | Cifrado de usuarios.numero_documento/telefono/genero y firmas_documento.numero_documento_firmante/firma_imagen |
| RF-TEC-019-02 | config_webhooks.secreto_cifrado entra en el inventario de rotación |
| RF-TEC-019-04 | Algoritmo de firma del JWT fijado en HS256 |
🔐 Cómo se cifra la PII
- Se reutiliza el
ValueTransformerde TEC-007 (AES-256-GCM, clave centralizada con rotación). numero_documentoera 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 → cifradoen una columnatext; el PDF sigue recibiendo elBuffer.- No se cifran
emailninombre(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 atext, 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
| Prueba | Resultado |
|---|---|
npx tsc --noEmit | Compila (solo errores de un spec ajeno: req-sec-12) |
Subconjunto cifrado + usuarios + firmas | 91/91 verde |
| Suite completa | 1127/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
- Especificación: TEC-019
- Validación de origen: Validación REQ-SEC-14
- Manual: Cifrado en reposo
