Esta página describe las versiones de MongoDB y del controlador con las que el cifrado de nivel de campo del lado del cliente 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.
Edición y compatibilidad de versiones 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.
El 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 controlador
Para utilizar el cifrado de nivel de campo del lado del cliente y la API de rotación de clave con el controlador C++, instale la versión del controlador 3.6.0 o posterior.
Para usar el cifrado de nivel de campo del lado del cliente con el controlador .NET/C#, instale 2.10.0 la versión o posterior. Para usar la API de rotación de claves, instale la versión 2.17.1 o posterior.
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
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 usar el cifrado de nivel de campo del lado del cliente con el controlador Go, instale 1.2 la versión o posterior. Para usar la API de rotación de claves, instale libmongocrypt 1.5.2 o posterior.
Para usar el cifrado a nivel de campo del lado del cliente con el controlador Java Sync o Java Reactive Streams, instale 3.10.0 la versión o posterior. Para usar la API de rotación de claves, instale la mongodb-crypt versión,,,1 73 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 de nivel de campo del lado del cliente y la API de rotación de clave con el controlador PHP, instale la versión del controlador 1.6.0 o posterior.
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 de nivel de campo del lado del cliente y la API de rotación de clave con el controlador Ruby, instale la versión del controlador 2.12.1 o posterior.
Para usar el cifrado de nivel de campo del lado del cliente con el controlador de Rust, instale 2.4.0 la versión o posterior. Para usar la API de rotación de claves, instale libmongocrypt 1.8versión.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 reenvolver claves de cifrado.