Docs Menu
Docs Home
/ /

Compatibilidad con CSFLE

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.

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.

Para utilizar el cifrado a nivel de campo del lado del cliente y la API de rotación de claves con Controlador C, instale 1.17.5 la versión del controlador 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 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_PATH variable de entorno a la ruta absoluta del archivo libmongocrypt.

  • 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 paquete MongoDB.Driver.Encryption que 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.

Volver

Utilice KMIP