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 mapa de campos criptografados 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 6.0 ou posterior
MongoDB Enterprise 6.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 Instalar e configurar mongocryptd para Queryable Encryption.
Para saber mais sobre criptografia automática, consulte Recursos.
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 a versão rotulada como "atual".
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 automática, crypt_shared.Padrão: undefined |
cryptSharedLibRequired | Especifica se o driver deve usar a biblioteca compartilhada de criptografia automática. Se true,o driver gera um erro se a biblioteca compartilhada de criptografia automática não estiver disponível. Se false, o condutor executará a seguinte sequência de ações:
Padrão: false |
Para visualizar um exemplo demonstrando como configurar estes parâmetros, consulte Início Rápido.