Instalar e configurar o mongocryptd para Queryable Encryption

Visão geral

mongocryptd está instalado com o servidor MongoDBMongoDB Enterprise MongoDB (versão 4.2 e posterior).

Quando você cria um MongoDB client habilitado para Queryable Encryption, o processo de mongocryptd é iniciado automaticamente por padrão e lida com as seguintes responsabilidades:

• Usa as regras de criptografia automática especificadas para marcar campos em operações de leitura e gravação para criptografia.

• Impede que operações não suportadas sejam executadas em campos criptografados.

• Analisa o esquema de criptografia especificado para a conexão do reconhecimento de data center. As regras de criptografia automática usam um subconjunto rigoroso da sintaxe de JSON schema. Se as regras de criptografia automática contiverem sintaxe de criptografia automática inválida ou qualquer sintaxe de validação de documento, o mongocryptd retornará um erro.

mongocryptd é responsável apenas pelas funções acima e não executa nenhuma das seguintes:

• mongocryptd não executa criptografia ou descriptografia em si

• mongocryptd não acessa nenhum material chave de criptografia

• mongocryptd não escuta pela rede

Drivers compatíveis com o MongoDB 4.2 e posterior usam a libmongocrypt licenciada pela Apache para executar criptografia no nível do campo no lado do cliente e descriptografia automática.

Os drivers compatíveis oficiais do MongoDB 4.2+, mongosh e o shell 4.2 ou posterior mongo legado exigem acesso ao processo mongocryptd na máquina host do cliente . Esses clientes procuram o processo mongocryptd no PATH do sistema por padrão.

Instalação

Para sistemas operacionais Linux compatíveis, instale o pacote do servidor seguindo o tutorial de instalação no Linux, siga as instruções de instalação documentadas e instale o pacote do servidor mongodb-enterprise. Ao mesmo tempo, especifique mongodb-enterprise-cryptd em vez de instalar somente o binário mongocryptd. O gerenciador de pacotes instala os binários em um local no PATH do sistema (por exemplo, /usr/bin/)

Para OSX, instale o pacote Server seguindo o tutorial de instalação no MacOS. O gerenciador de pacotes instala binários em um local no PATH do sistema.

Para Windows, instale o pacote Server seguindo o tutorial de instalação no Windows. Você deve adicionar o pacote mongocryptd ao PATH do seu sistema após a instalação. Consulte as práticas recomendadas documentadas para sua instalação do Windows para obter instruções sobre como adicionar o binário mongocryptd ao PATH do sistema.

Para instalações por meio de um arquivo tarball ou ZIP oficial, siga as práticas recomendadas documentadas para seu sistema operacional para adicionar o binário mongocryptd ao PATH do sistema.

Configuração

Se o driver compatível com 4,2+ tiver acesso ao processo mongocryptd , por padrão, o driver managed a criação do processo mongocryptd .

Você pode configurar como seu driver inicia mongocryptd por meio dos seguintes 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'])