Instalar y configurar mongocryptd para cifrado consultable

Overview

mongocryptd se instala con MongoDB Enterprise Server (versión 4.2 y posteriores).

Cuando crea un cliente MongoDB habilitado para cifrado consultable, el proceso mongocryptd se inicia automáticamente de manera predeterminada y maneja las siguientes responsabilidades:

• 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 de cifrado automático contienen una sintaxis de cifrado automático no válida o cualquier sintaxis de validación de documentos, mongocryptd devuelve un error.

mongocryptd Sólo es responsable de las funciones anteriores y no realiza ninguna de las siguientes:

• mongocryptd no realiza cifrado ni descifrado por sí mismo

• mongocryptd no accede a ningún material de clave de cifrado

• mongocryptd no escucha a través de la red

Los controladores compatibles con MongoDB 4.2 y posteriores utilizan la biblioteca libmongocrypt con licencia Apache. Biblioteca para realizar cifrado a nivel de campo del lado del cliente y descifrado automático.

Los 4.2controladores oficiales compatibles conmongosh MongoDB +,, y el 4.2 shell o mongo posterior,, requieren acceso 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 compatible con 4.2+ tiene acceso al proceso mongocryptd, de manera predeterminada el controlador administra el inicio del proceso mongocryptd.

Puede configurar cómo se inicia su 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'])