Overview
La librería compartida de cifrado automático es una librería dinámica que permite a la aplicación cliente realizar cifrado consultable automático. Una librería dinámica es un conjunto de funcionalidades a las que una aplicación accede en tiempo de ejecución en vez de en tiempo de compilación. La Librería Compartida de Cifrado Automático realiza las siguientes tareas:
Lee el mapa de campos cifrados para determinar qué campos cifrar o descifrar
Evita que su aplicación ejecute operaciones no compatibles en campos cifrados
La librería compartida de cifrado automático no realiza ninguna de las siguientes acciones:
Realizar cifrado o descifrado de datos
Accede al material de la llave de cifrado
Escuchar datos a través de la red
Importante
Productos de MongoDB Server compatibles
Automatic Queryable Encryption solo está disponible en los siguientes productos de servidor MongoDB:
Clústeres de MongoDB Atlas 6.0 o posteriores
MongoDB Enterprise 6.0 o posterior
La Automatic Queryable Encryption no está disponible en ninguna versión de MongoDB Community servidor.
La biblioteca compartida de cifrado automático es una alternativa preferida a mongocryptd y no requiere que inicies otro proceso para realizar cifrado automático.
Tip
Si bien recomendamos utilizar la librería compartida de cifrado automático, todavía se admite mongocryptd.
Para obtener más información sobre mongocryptd, consulte Instalar y configurar mongocryptd para cifrado consultable.
Para saber más sobre el cifrado automático, consulta Funcionalidades.
Descargar la biblioteca compartida de cifrado automático
Descargue la librería compartida de cifrado automático desde el Centro de descargas de MongoDB eligiendo la versión y la plataforma, y luego la librería:
En el Version En el menú desplegable, seleccione la versión etiquetada como "actual".
En el menú desplegable Platform, seleccione su plataforma.
En el menú desplegable Package, selecciona
crypt_shared.Haga clic en Download.
Tip
Para ver una lista ampliada de lanzamientos y paquetes disponibles, consulta Descargas de MongoDB Enterprise.
Configuración
Puede configurar cómo su controlador busca la biblioteca compartida de cifrado automático a través de los siguientes parámetros:
Nombre | Descripción |
|---|---|
Ruta de biblioteca compartida de crypt | 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 ver un ejemplo que demuestra cómo configurar estos parámetros, consulta la Guía rápida de la API.