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 o mongocryptd, consulte Instalar e configurar o 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 | Specifies the absolute path to the Automatic Encryption Shared Library package, crypt_shared.Default: undefined |
cryptSharedLibRequired | Specifies if the driver must use the Automatic Encryption Shared Library. If true,the driver raises an error if the Automatic Encryption Shared Library is unavailable. If false, the driver performs the following sequence of actions:
Default: false |
Para visualizar um exemplo demonstrando como configurar estes parâmetros, consulte Início Rápido.