/ /

Biblioteca compartilhada de criptografia automática para Queryable Encryption

Visão geral

A Automatic Encryption Shared Library é uma biblioteca dinâmica que permite que seu aplicativo cliente execute a Queryable Encryption automática. Uma biblioteca dinâmica é um conjunto de funcionalidades acessadas por um aplicativo no tempo de execução em vez de compilar tempo. A Biblioteca compartilhada de criptografia automática executa as seguintes tarefas:

Lê o esquema de criptografia para determinar quais campos criptografar ou descriptografar
Impede que seu aplicativo execute operações não suportadas em campos criptografados

A biblioteca compartilhada de criptografia automática não realiza nenhuma das seguintes ações:

Executar criptografia ou descriptografia de dados
Acessar o material da chave de criptografia
Escutar dados pela rede

Importante

Produtos de servidor MongoDB suportados

A Queryable Encryption só está disponível nos seguintes produtos de servidor MongoDB:

Clusters do MongoDB Atlas 7.0 ou posterior
MongoDB Enterprise 7.0 ou posterior

A Queryable Encryption não está disponível em nenhuma versão do MongoDB Community Server.

A Biblioteca compartilhada de criptografia automática é uma alternativa preferencial ao mongocryptd e não exige que você inicie outro processo para executar a criptografia automática.

Dica

Embora seja recomendável usar a Biblioteca Compartilhada de Criptografia Automática, o mongocryptd ainda é suportado.

Para saber mais sobre mongocryptd, consulte Install and Configure mongocryptd for Queryable Encryption.

Para saber mais sobre criptografia automática, consulte Recursos de Queryable Encryption.

Baixar a biblioteca compartilhada de criptografia automática

Baixe a Biblioteca compartilhada de criptografia automática na Central de download do MongoDB selecionando a versão e a plataforma e, em seguida, a biblioteca:

No menu suspenso Version, selecione 7.0.0 (current).
No menu suspenso Platform, selecione sua plataforma.
No menu suspenso Package, selecione crypt_shared.
Clique em Download.

Dica

Para ver uma lista expandida de versões e pacotes disponíveis, consulte Downloads do MongoDB Enterprise.

Configuração

Você pode configurar como seu driver procura a Biblioteca Compartilhada de Criptografia Automática por meio dos seguintes parâmetros:

Nome	Descrição
cryptSharedLibPath	Especifica o caminho absoluto para o pacote Biblioteca compartilhada de criptografia `crypt_shared` automática,. Padrão: `undefined`
cryptSharedLibRequired	Especifica se o driver deve usar a biblioteca compartilhada de criptografia automática.`true` Se, o driver gera um erro se a biblioteca compartilhada de criptografia automática não estiver disponível. `false`Se, o condutor executará a seguinte sequência de ações: Tentar usar a Biblioteca compartilhada de criptografia automática. Se a biblioteca compartilhada de criptografia automática não estiver disponível, o driver tentará gerar e se conectar a `mongocryptd`. Padrão: `false`

Nome

Descrição

cryptSharedLibPath

Especifica o caminho absoluto para o pacote Biblioteca compartilhada de criptografia
crypt_shared automática,.
Padrão: undefined

cryptSharedLibRequired

Especifica se o driver deve usar a biblioteca compartilhada de criptografia automática.true Se,
o driver gera um erro se a biblioteca compartilhada de criptografia automática não estiver disponível.
falseSe, o condutor executará a seguinte sequência de ações:

Tentar usar a Biblioteca compartilhada de criptografia automática.
Se a biblioteca compartilhada de criptografia automática não estiver disponível, o driver tentará gerar e se conectar a mongocryptd.

Padrão: false

Para visualizar um exemplo demonstrando como configurar estes parâmetros, consulte Início Rápido.

Voltar

MongoClientOptions

Usar mongocryptd