Overview
Esta página describe la configuración del servidor para admitir el cifrado en reposo. Si usa MongoDB Atlas, sus datos ya están cifrados. MongoDB gestiona el cifrado de Atlas a nivel de proveedor de la nube, pero también puede usar su propia solución de gestión de claves. Consulte la documentación de gestión de claves de Atlas para obtener más información.
MongoDB Enterprise 3.2 introduce una opción de cifrado nativo para el motor de almacenamiento WiredTiger. Fuera de Atlas, el cifrado solo está disponible para instalaciones empresariales que utilizan el motor de almacenamiento WiredTiger.
La gestión segura de las claves de cifrado es un requisito fundamental para el cifrado del almacenamiento. MongoDB utiliza una clave maestra que no se almacena con la instalación. Solo la clave maestra se gestiona externamente; otras claves se pueden almacenar con la instancia de MongoDB.
El motor de almacenamiento cifrado de MongoDB proporciona dos opciones de gestión de claves para la clave maestra:
Integración con un dispositivo de gestión de claves de terceros a través del Protocolo de Interoperabilidad de Gestión de Claves (KMIP). Recomendado
Uso de la gestión local de llaves a través de un archivo llave.
Importante
MongoDB no puede encriptar los datos existentes. Cuando activas el cifrado con una clave nueva, la instancia de MongoDB no puede contener ningún dato preexistente. Si tu instalación de MongoDB ya tiene datos existentes, consulta Cifrar datos en reposo para pasos adicionales.
Administrador de claves
MongoDB Enterprise admite la transferencia segura de claves con dispositivos de gestión de claves compatibles. Utilizar un administrador de llaves permite que las llaves se almacenen en el administrador de llaves.
MongoDB Enterprise admite la transferencia segura de claves con dispositivos de gestión de claves que cumplen con el protocolo de Interoperabilidad de Gestión de Claves (KMIP).
Para obtener una lista de los socios certificados de MongoDB, consulta la Lista de socios.
Tip
Recomendado
Utilizar un administrador de claves cumple con las directrices regulatorias de gestión de claves, como HIPAA, PCI-DSS y FERPA, y es recomendable en comparación con la gestión local de claves.
Requisitos previos
Su administrador de claves debe admitir el protocolo de comunicación KMIP.
La versión por defecto del protocolo KMIP es 1.2. Puede configurar MongoDB para usar la versión KMIP 1.0 o 1.1 en el servidor MongoDB archivo de configuración.
Para una integración con un sistema externo de gestión de claves usando el KMIP, debe permitir las siguientes operaciones KMIP:
Crear (
operation_create)Obtener (
operation_get)Activar (
operation_activate)
Para autenticar MongoDB ante un servidor KMIP, debes tener un certificado válido expedido por el dispositivo de gestión de llaves.
Nota
MongoDB Enterprise en Windows ya no admite AES256-GCM como un cifrado de bloques para el cifrado en reposo. Este uso solo es compatible con Linux.
Cifrar usando una nueva clave
Para crear una clave nueva al conectar con el gestor de claves, utiliza las siguientes opciones para iniciar mongod:
Para conectarse a un servidor KMIP versión 1.0 o 1.1, utilice la opción --kmipUseLegacyProtocol.
Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.
La siguiente operación crea una nueva clave principal en su administrador de claves. mongod usa la clave maestra para cifrar las claves que mongod genera para cada base de datos.
mongod --enableEncryption \ --kmipServerName <KMIP Server HostName> \ --kmipPort <KMIP server port> \ --kmipServerCAFile ca.pem \ --kmipClientCertificateFile client.pem
mongod verifica la conexión al servidor KMIP al inicio.
El nombre del servidor especificado en --kmipServerName debe coincidir con el Nombre Alternativo del Sujeto SAN o con el Nombre común CN en el certificado presentado por el servidor KMIP. SAN puede ser un nombre de sistema o una dirección IP.
Si SAN está presente, mongod no intenta coincidir con CN.
Si el nombre de host o la dirección IP del servidor KMIP no coincide con SAN ni con CN, mongod no se iniciará.
Para verificar que la creación y uso de la clave fue exitosa, revisa la entrada de registro. Si es exitoso, el proceso registrará los siguientes mensajes:
[initandlisten] Created KMIP key with id: <UID> [initandlisten] Encryption key manager initialized using master key with id: <UID>
Cifrar con una clave existente
Puedes usar una clave maestra existente que tu servidor KMIP ya administra. Para usar una clave existente, utiliza estas opciones cuando inicies mongod para conectar mongod al administrador de claves:
Para conectarse a un servidor KMIP versión 1.0 o 1.1, utilice la opción --kmipUseLegacyProtocol.
Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.
mongod --enableEncryption \ --kmipServerName <KMIP Server HostName> \ --kmipPort <KMIP server port> \ --kmipServerCAFile ca.pem \ --kmipClientCertificateFile client.pem \ --kmipKeyIdentifier <UID>
mongod verifica la conexión al servidor KMIP al inicio.
El nombre del servidor especificado en --kmipServerName debe coincidir con el Nombre Alternativo del Sujeto SAN o con el Nombre común CN en el certificado presentado por el servidor KMIP. SAN puede ser un nombre de sistema o una dirección IP.
Si SAN está presente, mongod no intenta coincidir con CN.
Si el nombre de host o la dirección IP del servidor KMIP no coincide con SAN ni con CN, mongod no se iniciará.
Gestión local de claves
Importante
El uso del método keyfile no cumple con la mayoría de las directrices regulatorias de gestión de claves y requiere que los usuarios gestionen de manera segura sus propias claves.
La gestión segura del archivo de claves es fundamental.
Para cifrar con un archivo de claves, debe tener un archivo de claves codificado en base64 que contenga una única cadena de 16 o 32 caracteres. Solo el propietario del proceso debe poder acceder a este archivo de claves.mongod
Cree el archivo de claves codificado en base64 con la string de 16 o 32 caracteres. Se puede generar el archivo clave codificado utilizando cualquier método que se prefiera. Por ejemplo,
openssl rand -base64 32 > mongodb-keyfile Actualiza los permisos del archivo.
chmod 600 mongodb-keyfile Para utilizar el archivo de clave, inicie con las siguientes
mongodopciones:--enableEncryption,--encryptionKeyFile <path to keyfile>,
mongod --enableEncryption --encryptionKeyFile mongodb-keyfile Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el
--bind_ip.Verifique si el administrador de claves de cifrado se inicializó correctamente con el archivo de claves. Si la operación se realizó correctamente, el proceso registrará el siguiente mensaje:
[initandlisten] Encryption key manager initialized with key file: <path to keyfile>
Encriptar datos existentes en reposo
MongoDB no puede encriptar los datos existentes. Cuando habilitas el cifrado con una nueva clave, la instancia de MongoDB no puede tener ningún dato preexistente.
Si estás utilizando un set de réplicas que sí tiene datos existentes, utiliza una sincronización inicial en escala para cifrar los datos.
Por ejemplo, considere un set de réplicas con tres nodos. El set de réplicas está en uso y contiene datos que deseas cifrar. Estos son los pasos que deberías seguir para cifrar los datos en reposo:
Prepara un servidor.
Siga estos pasos para preparar el servidor:
Elija uno de los servidores secundarios.
Deten
mongoden el servidor secundario.Opcional: Realizar una copia de seguridad de los datos en
dbPath. Si no se requiere una copia de seguridad completa, considera hacer una copia de seguridad solo del directoriodiagnostic.datapara preservar datos de solución de problemas potencialmente útiles en caso de inconvenientes. Consulta Captura de Datos Diagnósticos a Tiempo Completo para más información.Elimine los archivos y directorios
dbPathen.
Habilitar el cifrado.
Inicie el servidor secundario con el cifrado activado. La mongod instancia crea un nuevo almacén de claves.
Sincronizar los datos.
Importar los datos del sistema principal. Inicia el proceso mongod, especificando las opciones de replicación según corresponda.
mongod Realiza una sincronización inicial y encripta los datos durante el proceso de sincronización.
Repetir el proceso en los secundarios.
Cuando la primera instancia secundaria haya terminado de importar y cifrar los datos, repita el proceso en las otras instancias mongod secundarias.
Cifrar el primario.
Cuando todos los secundarios hayan sido cifrados, step down el principal. Los secundarios elegibles elegirán un nuevo primario.
La antigua principal ahora es una secundaria. Repetir los pasos para remover los datos no cifrados y luego ejecutar una sincronización inicial.