Esta página describe las versiones de MongoDB y los drivers con las cuales el cifrado del lado del cliente a nivel de campo es compatible.
➤ Utilice el menú desplegable Seleccione su idioma para seleccionar su controlador y ver su compatibilidad con el cifrado de nivel de campo del lado del cliente.
Compatibilidad de la edición y versión de MongoDB
El cifrado automático con el cifrado a nivel de campo del lado del cliente solo está disponible con MongoDB Enterprise Edition, versión 4.2 o posterior.
Cifrado explícito con cifrado a nivel de campo del lado del cliente está disponible con MongoDB Community y Enterprise Edition, versión 4.2 o posterior.
Compatibilidad del driver
Para utilizar el cifrado a nivel de campo del lado del cliente y la API de rotación de claves con el controlador C++, instale la versión 3.6.0 o superior del controlador.
Para utilizar el cifrado a nivel de campo del lado del cliente con el driver .NET/C#, instala la versión 2.10.0 del driver o una posterior. Para utilizar la API de Rotación de Claves, instala la versión 2.17.1 del controlador o una posterior.
Si está utilizando la versión del controlador 3.0 o posterior, también debe completar los siguientes pasos:
Instala el MongoDB.driver.cifrado Paquete de NuGet. Este paquete permite el cifrado automático.
Si su aplicación se ejecuta en Linux, instale libmongocrypt manualmente. Luego, configure
LIBMONGOCRYPT_PATHvariable de entorno a la ruta absoluta del archivolibmongocrypt.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>
Para utilizar el cifrado a nivel de campo del lado del cliente con el driver Go, instala el driver versión 1.2 o posterior. Para utilizar la API de rotación de claves, instala la libmongocrypt versión 1.5.2 o posterior.
Para usar el cifrado a nivel de campo del lado del cliente con el driver Java Sync o Java Reactive Streams, instala la versión 3.10.0 o superior del driver. Para utilizar la API de rotación de claves, instala mongodb-crypt versión 1.7.3 o posterior.
Para usar el cifrado a nivel de campo del lado del cliente con el controlador Java Reactive Streams, instale 1.12.0 la versión o posterior. Para usar la API de rotación de claves, instale la mongodb-crypt versión 1.7.3 o posterior.
Para usar el cifrado de nivel de campo del lado del 3.4.0 cliente con el controlador de Node.js, instale la versión o posterior. Para usar la API de rotación de claves, instale mongodb-client-encryption 2 2versión..0 2-.x.
Si está utilizando la versión 6.0 o posterior del controlador Node.js, también debe utilizar la versión 6.0 o posterior de mongodb-client-encryption.
Para utilizar el cifrado a nivel de campo del lado del cliente y la API de rotación de claves con el driver PHP, instala la versión 1.6.0 o posterior del driver.
Para usar el cifrado a nivel de campo del lado del cliente con PyMongo, instala la versión del controlador 3.10.0 o posterior. Para usar la API de rotación de claves, instala la versión pymongocrypt 1.3.1 o posterior.
Para utilizar el cifrado a nivel de campo del lado del cliente y la API de rotación de claves con el driver de Ruby, instala la versión 2.12.1 del driver o posterior.
Para utilizar el cifrado del lado del cliente a nivel de campo con el controlador Rust, instala la versión del controlador 2.4.0 o posterior. Para usar la API de rotación de claves, instala libmongocrypt versión 1.8.0 o posterior.
Para utilizar el cifrado a nivel de campo del lado del cliente y la API de rotación de claves con el driver de Scala, instala la versión del driver 2.7.0 o posterior.
Para obtener más información sobre la API de rotación de claves, consulte Rotar y volver a envolver las claves de cifrado.