security: vault v3 — PBKDF2 + envelope encryption (DEK/KEK)
Reemplaza derivación SHA256 por PBKDF2-HMAC-SHA256 (600k iter) con salt aleatorio por tenant + DEK de 32 bytes aleatoria por cifrado. Robar la DB sin FERNET_KEY o FERNET_KEY sin la DB ya no alcanza para comprometer credenciales. Compatibilidad v1 preservada para migración. Agrega migrar_vault_v3.py con dry-run, pre-flight check y backup atómico. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
22
CHANGELOG.md
22
CHANGELOG.md
@@ -11,6 +11,28 @@ Versiones: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
|
||||
|
||||
---
|
||||
|
||||
## [0.4.0] — 2026-05-26
|
||||
|
||||
### Security
|
||||
|
||||
- **Envelope encryption v3 en `vault.py`** — credenciales cifradas en dos capas independientes:
|
||||
- DEK (Data Encryption Key): 32 bytes aleatorios, única por operación de cifrado.
|
||||
- Wrapping Key: derivada de `FERNET_KEY` con PBKDF2-HMAC-SHA256, 600k iteraciones, salt de 16 bytes aleatorio por tenant. ~200ms por derivación — fuerza bruta inviable incluso con GPU.
|
||||
- Formato en DB: `{"v":3,"s":"<salt_b64>","k":"<dek_enc>","p":"<payload_enc>"}`
|
||||
- Propiedades: robar la DB sin `FERNET_KEY` es inútil; robar `FERNET_KEY` sin la DB también.
|
||||
- **Cache de wrapping keys** (`lru_cache`) — evita ejecutar PBKDF2 600k iter por cada tenant en cada ciclo del poller. Cache key incluye fingerprint del KEK para invalidar si cambia `FERNET_KEY`.
|
||||
- **Compatibilidad v1 preservada** — `descifrar_credenciales` detecta automáticamente formato v1 (Fernet token puro) vs v3 (JSON). No se generan nuevas v1.
|
||||
|
||||
### Added
|
||||
|
||||
- **`scripts/migrar_vault_v3.py`** — migración segura de credenciales v1 → v3:
|
||||
- Verifica que todos los tenants v1 sean descifrables ANTES de tocar la DB (aborta si alguno falla).
|
||||
- Backup automático de la DB antes de cualquier escritura.
|
||||
- Flag `--dry-run` para ver qué haría sin modificar nada.
|
||||
- Commit atómico: o migra todos o no migra ninguno.
|
||||
|
||||
---
|
||||
|
||||
## [0.3.1] — 2026-05-26
|
||||
|
||||
### Security
|
||||
|
||||
Reference in New Issue
Block a user