Overview
Obtenga información sobre las aplicaciones y bibliotecas que debe instalar para utilizar el cifrado de nivel de campo del lado del cliente (CSFLE).
Lo que usted necesita
Antes de poder utilizar CSFLE, debe configurar los siguientes elementos en su entorno de desarrollo:
(Opcional) Descargue la biblioteca compartida de cifrado automático. Esta biblioteca es una alternativa preferida a mongocryptd y no requiere generar un nuevo proceso.
mongocryptdTodavía se admite.Instalar Edición empresarial de MongoDB.
Instalar un controlador MongoDB compatible con CSFLE.
Consulte Primeros pasos para obtener información sobre cómo iniciar una instancia de MongoDB.
Asegúrese de utilizar un sistema operativo x64. CSFLE requiere compatibilidad con x64.
Si está utilizando la versión del controlador 3.0 o posterior, también debe completar los siguientes pasos:
Instalar MongoDB.Driver.Encryption Paquete de NuGet. Este paquete permite el cifrado automático.
Si su aplicación se ejecuta en Linux, instale libmongocrypt manualmente. Luego, configure la
LIBMONGOCRYPT_PATHvariable de entorno con la ruta absoluta dellibmongocryptarchivo.Si su aplicación se ejecuta en Linux de 64bits y utiliza la versión del controlador 3.4.3 o anterior, agregue las siguientes líneas de XML a su archivo
.csproj. Cambie el valor del elemento<MongoDriverEncryptionVersion>para que coincida con la versión del paqueteMongoDB.Driver.Encryptionque tenga instalado.
<PropertyGroup> <!-- replace the version here with your package version --> <MongoDriverEncryptionVersion>3.4.2</MongoDriverEncryptionVersion> <MongoDriverEncryptionPath>$(NuGetPackageRoot)mongodb.driver.encryption\$(MongoDriverEncryptionVersion)</MongoDriverEncryptionPath> </PropertyGroup> <PropertyGroup> <!-- Suppresses the duplicate file error --> <ErrorOnDuplicatePublishOutputFiles>false</ErrorOnDuplicatePublishOutputFiles> </PropertyGroup> <!-- Ensures the correct library after build or publish --> <Target Name="EnsureCorrectMongoEncryption" AfterTargets="Build;Publish" Condition="'$(RuntimeIdentifier)' != ''"> <!-- Determine paths based on current operation --> <PropertyGroup> <_TargetDir Condition="Exists('$(PublishDir)')">$(PublishDir)</_TargetDir> <_TargetDir Condition="'$(_TargetDir)' == ''">$(OutputPath)</_TargetDir> </PropertyGroup> <!-- Copy the correct library based on runtime identifier (RID) --> <ItemGroup> <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/x64/libmongocrypt.so" Condition="'$(RuntimeIdentifier)' == 'linux-x64'" /> <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/arm64/libmongocrypt.so" Condition="'$(RuntimeIdentifier)' == 'linux-arm64'" /> <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/alpine/libmongocrypt.so" Condition="'$(RuntimeIdentifier)' == 'linux-musl-arm64'" /> </ItemGroup> <!-- Copy with overwrite --> <Copy SourceFiles="@(_CorrectMongoLib)" DestinationFolder="$(_TargetDir)" Condition="'@(_CorrectMongoLib)' != ''" OverwriteReadOnlyFiles="true" /> <Message Text="Fixed MongoDB encryption library for $(RuntimeIdentifier)" Condition="'@(_CorrectMongoLib)' != ''" /> </Target>
(Opcional) Descargue la biblioteca compartida de cifrado automático. Esta biblioteca es una alternativa preferida a mongocryptd y no requiere generar un nuevo proceso.
mongocryptdaún es compatible.Instalar MongoDB Enterprise Edition.
Instalar un controlador MongoDB compatible con CSFLE.
Consulte Primeros pasos para obtener información sobre cómo iniciar una instancia de MongoDB.
Instala libmongocrypt. La librería
libmongocryptcontiene acoplamientos para comunicarse con la librería nativa que gestiona el cifrado.
(Opcional) Descargue la biblioteca compartida de cifrado automático. Esta biblioteca es una alternativa preferida a mongocryptd y no requiere generar un nuevo proceso.
mongocryptdaún es compatible.Instalar MongoDB Enterprise Edition.
Instalar un controlador MongoDB compatible con CSFLE.
Consulte Primeros pasos para obtener información sobre cómo iniciar una instancia de MongoDB.
Instale mongodb-crypt. La
mongodb-cryptbiblioteca contiene enlaces para comunicarse con la biblioteca nativa que administra el cifrado.
(Opcional) Descargue la biblioteca compartida de cifrado automático. Esta biblioteca es una alternativa preferida a mongocryptd y no requiere generar un nuevo proceso.
mongocryptdaún es compatible.Instalar MongoDB Enterprise Edition.
Instalar un controlador MongoDB compatible con CSFLE.
Consulte Primeros pasos para obtener información sobre cómo iniciar una instancia de MongoDB.
Instale mongodb-client-encryption, un contenedor de Node.js para la
libmongocryptbiblioteca de cifrado. Lalibmongocryptbiblioteca contiene enlaces para comunicarse con la biblioteca nativa que gestiona el cifrado.
Al utilizar la versión del controlador Node.js 6.0.0 o posterior, mongodb-client-encryption debe tener el mismo número de versión principal que el controlador.
Por ejemplo, el controlador Node.js v6.xx requiere mongodb-client-encryption v6.xx
(Opcional) Descargue la biblioteca compartida de cifrado automático. Esta biblioteca es una alternativa preferida a mongocryptd y no requiere generar un nuevo proceso.
mongocryptdaún es compatible.Instalar MongoDB Enterprise Edition.
Instalar un controlador MongoDB compatible con CSFLE.
Consulte Primeros pasos para obtener información sobre cómo iniciar una instancia de MongoDB.
Instale pymongocrypt, un contenedor de Python para la
libmongocryptbiblioteca de cifrado. Lalibmongocryptbiblioteca contiene enlaces para comunicarse con la biblioteca nativa que gestiona el cifrado.
Obtén más información
Para comenzar a usar CSFLE, consulta la Guía de inicio rápido de CSFLE.
Para aprender a utilizar CSFLE con un proveedor de sistema de administración de claves remoto, consulte Tutoriales de CSFLE.