Instalar y configurar mongocryptd para CSFLE

Overview

mongocryptd se instala con Servidor empresarial MongoDB.

Cuando crea un cliente MongoDB habilitado para CSFLE, el proceso mongocryptd se inicia automáticamente de forma predeterminada.

El proceso mongocryptd:

• Utiliza las reglas de cifrado automático especificadas para marcar campos en operaciones de lectura y escritura para el cifrado.

• Evita que se ejecuten operaciones no admitidas en campos cifrados.

• Analiza el esquema de cifrado especificado para la conexión a la base de datos. Las reglas de cifrado automático utilizan un subconjunto estricto de la sintaxis del esquema JSON. Si las reglas contienen una sintaxis de cifrado automático no válida o cualquier schema validation sintaxis, mongocryptd devuelve un error.

mongocryptd sólo realiza las funciones anteriores y no realiza ninguna de las siguientes:

• mongocryptd No realiza cifrado ni descifrado

• mongocryptd no accede a ninguna llave de cifrado

• mongocryptd no escucha a través de la red

Para realizar el cifrado a nivel de campo del lado del cliente y el descifrado automático, los controladores utilizan libmongocrypt con licencia Apache. Biblioteca

Los controladores oficiales de MongoDB,, mongosh y el shell heredado requieren acceso mongo al mongocryptd proceso en el host del cliente. Estos clientes buscan el mongocryptd proceso en la ruta del sistema de forma predeterminada.

Instalación

Para sistemas operativos Linux compatibles, instale el paquete Server siguiendo el tutorial de instalación en Linux, siga las instrucciones de instalación documentadas e instale el mongodb-enterprise paquete Server. Como alternativa, especifique mongodb-enterprise-cryptd para instalar solo el mongocryptd binario. El administrador de paquetes instala los binarios en una ubicación en la ruta del sistema (p. ej.,). /usr/bin/

Para OSX, instale el paquete Server siguiendo el tutorial de instalación en macOS. El administrador de paquetes instala los binarios en una ubicación en la ruta del sistema.

En Windows, instale el paquete Server siguiendo el tutorial de instalación en Windows. Debe agregar el paquete a la ruta del mongocryptd sistema después de la instalación. Consulte las prácticas recomendadas documentadas para su instalación en Windows para obtener instrucciones sobre cómo agregar el mongocryptd binario a la ruta del sistema.

Para instalaciones a través de un archivo tarball o ZIP oficial, siga las mejores prácticas documentadas para su sistema operativo para agregar el binario mongocryptd a la RUTA de su sistema.

Configuración

Si el controlador tiene acceso al proceso mongocryptd, lo genera por defecto. Su aplicación debe tener permisos de escritura en el directorio de trabajo para crear el archivo mongocryptd.pid.

Configure cómo se inicia el controlador mongocryptd a través de los siguientes parámetros:

var extraOptions = new Dictionary<string, object>()
{
    { "mongocryptdSpawnArgs", new [] { "--port=30000" } },
};
autoEncryptionOptions.With(extraOptions: extraOptions);

var extraOptions = new Dictionary<string, object>()
{
    { "idleShutdownTimeoutSecs", 60 },
};
autoEncryptionOptions.With(extraOptions: extraOptions);

extraOptions := map[string]interface{}{
    "mongocryptdSpawnArgs": []string{
        "--port=30000",
    },
}

extraOptions := map[string]interface{}{
    "mongocryptdSpawnArgs": []string{
        "--idleShutdownTimeoutSecs=75",
    },
}

List<String> spawnArgs = new ArrayList<String>();
spawnArgs.add("--port=30000");
Map<String, Object> extraOpts = new HashMap<String, Object>();
extraOpts.put("mongocryptdSpawnArgs", spawnArgs);
AutoEncryptionSettings autoEncryptionSettings = AutoEncryptionSettings.builder()
    ...
    .extraOptions(extraOpts);

List<String> spawnArgs = new ArrayList<String>();
spawnArgs.add("--idleShutdownTimeoutSecs")
    .add("60");
Map<String, Object> extraOpts = new HashMap<String, Object>();
extraOpts.put("mongocryptdSpawnArgs", spawnArgs);
AutoEncryptionSettings autoEncryptionSettings = AutoEncryptionSettings.builder()
    ...
    .extraOptions(extraOpts);

autoEncryption: {
  ...
  extraOptions: {
    mongocryptdSpawnArgs: ["--port", "30000"],
    mongocryptdURI: 'mongodb://localhost:30000',
  }

autoEncryption: {
  ...
  extraOptions: {
    mongocryptdSpawnArgs: ["--idleShutdownTimeoutSecs", "75"]
  }

auto_encryption_opts = AutoEncryptionOpts(mongocryptd_spawn_args=['--port=30000'])

auto_encryption_opts = AutoEncryptionOpts(mongocryptd_spawn_args=['--idleShutdownTimeoutSecs=75'])