Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /

Compatibilidad con CSFLE

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 lenguaje para seleccionar su driver y ver su compatibilidad con lado del cliente Field Level Encryption.

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.

Para utilizar el cifrado a nivel de campo del lado del cliente y la API de rotación de claves con la C controlador, instala la versión del controlador 1.17.5 o posterior.

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ás utilizando la versión de controlador 3.0 o posterior, también debes completar los siguientes pasos:

  • Instala el MongoDB.driver.cifrado paquete de NuGet. Este paquete permite el cifrado automático.

  • Si tu aplicación se ejecuta en Linux, instala libmongocrypt manualmente. Luego, establece el LIBMONGOCRYPT_PATH variable de entorno a la ruta absoluta del archivo libmongocrypt.

  • Si tu aplicación se ejecuta en Linux 64-bit y estás usando la versión del controlador 3.4.3 o anterior, agrega las siguientes líneas de XML a tu archivo .csproj. Cambia el valor del elemento <MongoDriverEncryptionVersion> para que coincida con la versión del paquete MongoDB.Driver.Encryption que tienes 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 la encriptación a nivel de campo del lado del cliente, la encriptación explícita o la API de rotación de claves con el driver de Go, instala la versión 1.2 o posterior del driver de Go e instala la versión 1.5.2 o posterior de libmongocrypt.

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 utilizar el cifrado a nivel de campo del lado del cliente con el controlador de Java Reactive Streams, instala la versión 1.12.0 o superior del controlador. Para usar la API de rotación de llaves, instala mongodb-crypt versión 1.7.3 o posterior.

Para utilizar el cifrado a nivel de campo del lado del cliente con el controlador Node.js, instale la versión 3.4.0 o posterior del controlador. Para usar la API de Rotación de Claves, instala la versión mongodb-client-encryption 2.2.0 - 2.x.

Si utilizas la versión 6.0 o posterior del controlador de Node.js, también debes usar 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.

Volver

Usar KMIP