MongoDB
Explica cómo Field-Level Encryption y Queryable Encryption protegen campos sensibles desde el cliente y qué límites introducen en consultas, claves y operación.
El cifrado a nivel de campo protege valores sensibles antes de que lleguen al servidor. Con Client-Side Field Level Encryption —CSFLE— el driver cifra y descifra en una aplicación autorizada. Queryable Encryption amplía este modelo para permitir determinadas consultas sobre campos cifrados sin revelar el texto original al servidor, bajo capacidades que dependen de versión, driver y plataforma.
dato en aplicación
→ driver + clave de datos
→ ciphertext
→ MongoDB almacena y procesa lo permitidoNo sustituye TLS, cifrado at rest, autenticación ni autorización. Cada capa protege amenazas distintas.
CSFLE ayuda cuando no quieres que operadores del servidor, backups o snapshots vean ciertos valores en texto plano. No protege si:
Antes de implementarlo define qué actor no debe poder ver qué dato.
Las claves de datos cifradas se almacenan en una key vault collection. Una master key gestionada por KMS protege esas claves.
KMS master key
→ cifra data encryption keys
→ key vault
→ cifra campos de aplicaciónEl acceso a la key vault y al KMS debe estar separado del acceso normal a datos. Si una identidad obtiene ambos sin límites, la protección se debilita.
En CSFLE clásico, un cifrado determinístico produce el mismo ciphertext para el mismo valor y clave, permitiendo algunas búsquedas por igualdad. También revela patrones: valores repetidos generan ciphertext repetido.
El cifrado aleatorio produce resultados distintos y ofrece mayor ocultamiento de frecuencia, pero no permite igualdad directa.
La elección debe partir de la consulta necesaria, no de comodidad.
Queryable Encryption utiliza estructuras y protocolos específicos para soportar operaciones compatibles sobre datos cifrados. Las capacidades pueden incluir igualdad y otras consultas según release. No asumas que cualquier range, sort, regex, aggregation o índice normal funcionará.
Antes de diseñar verifica:
El driver usa un schema o encrypted fields map para cifrar campos sin que cada llamada lo haga manualmente. Reduce errores, pero una configuración equivocada puede dejar campos sin cifrar o impedir queries.
La aplicación invoca cifrado y descifrado directamente. Aporta control, pero aumenta código y riesgo de usar algoritmo, clave o tipo incorrectos.
En ambos casos valida runtime y prueba documentos reales.
const encryptedClient = new MongoClient(uri, {
autoEncryption: {
keyVaultNamespace: 'encryption.__keyVault',
kmsProviders,
encryptedFieldsMap
}
});No guardes credenciales de KMS en el repositorio. Usa workload identity o secrets manager cuando estén disponibles.
El ciphertext conserva metadata de tipo. String, number, Date y Decimal128 no son equivalentes. Cambiar el tipo de un campo cifrado requiere una migración explícita y puede afectar consultas.
No conviertas todos los valores a string para simplificar: pierdes semántica, orden y validación.
Rotar puede significar:
No todas implican reescribir los datos. Documenta el procedimiento, capacidad, rollback y duración. Una rotación incompleta puede dejar lectores incapaces de descifrar versiones antiguas.
El backup debe incluir:
Restaurar datos sin claves produce información inutilizable. Guardar claves junto al backup sin controles independientes reduce seguridad.
Prueba un restore en un entorno aislado y confirma que una identidad autorizada puede descifrar.
El cifrado añade:
Mide p50, p95 y p99 con carga y pools reales. No hagas benchmarks con claves cacheadas únicamente si el arranque en frío importa.
No registres plaintext antes de cifrar ni después de descifrar. Sanitiza:
Observa fallos de KMS, key vault, descifrado, schema mismatch y latencia sin exponer valores.
Una aplicación con permiso de descifrar debe seguir aplicando tenant y permisos de usuario. El cifrado no sabe si el usuario final puede ver ese documento.
Separa servicios cuando solo uno necesita plaintext. Por ejemplo, un worker de pagos puede descifrar un identificador que la API general nunca debería ver.
Secuencia:
No hagas una transacción gigante. Conserva checkpoint y distingue documentos cifrados de pendientes.
El cifrado a nivel de campo reduce quién puede ver datos incluso dentro de la infraestructura, pero traslada confianza a la aplicación y al sistema de claves. CSFLE y Queryable Encryption requieren diseño de consultas, KMS, rotación, backups, tipos y rendimiento. Sin recuperación de claves y control de plaintext fuera de MongoDB, la protección queda incompleta.
Operator injection y seguridad de consultas.