Compatibilidad

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

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 utiliza la versión del controlador 3.0 o posterior:

• Instale el paquete MongoDB.Driver.Encryption desde NuGet. Este paquete permite el cifrado automático.

• Si su aplicación se ejecuta en Linux, instale libmongocrypt manualmente. Luego, configure la variable de entorno LIBMONGOCRYPT_PATH a la ruta absoluta del archivo libmongocrypt.

• Si tu aplicación se ejecuta en un Linux de 64bits y estás utilizando la versión 3.4.3 o anterior del controlador, agrega el siguiente XML a tu archivo .csproj.

  Reemplaza <MongoDriverEncryptionVersion> con la versión instalada del paquete MongoDB.Driver.Encryption:

  <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 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 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 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.