Compatibilidade

Para usar a criptografia no nível do campo do lado do cliente e a API de rotação de chaves com o driver C, instale a versão do driver 1.17.5 ou posterior.

Para usar a criptografia no nível do campo do lado do cliente e a API de rotação de chaves com o driver C++, instale a versão 3.6.0 do driver ou posterior.

Para usar a criptografia no nível do campo do lado do cliente com o driver .NET/C#, instale a versão do driver 2.10.0 ou posterior. Para usar a API de rotação de chaves, instale a versão do driver 2.17.1 ou posterior.

Se você estiver usando a versão 3.0 do driver ou posterior:

• Instale o pacote MongoDB.Driver.Encryption do NuGet. Este pacote habilita a criptografia automática.

• Se seu aplicação for executado no Linux, instale libmongocrypt manualmente. Em seguida, defina a LIBMONGOCRYPT_PATH variável de ambiente para o caminho absoluto do libmongocrypt arquivo.

• Se seu aplicação for executado no Linux de 64bits e você estiver usando a versão do driver 3.4.3 ou anterior, adicione o seguinte XML ao seu arquivo .csproj.

  Substitua <MongoDriverEncryptionVersion> pela versão instalada do pacote 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 usar a criptografia no nível do campo do lado do cliente com o driver Go, instale a versão do driver 1.2 ou posterior. Para usar a API de rotação de chaves, instale a versão 1.5.2 da libmongocrypt ou posterior.

Para usar a criptografia em nível de campo do lado do cliente com o driver Java Reactive Streams, instale a versão do driver 1.12.0 ou posterior. Para usar a API de rotação de chaves, instale a versão mongodb-crypt 1.7.3 ou posterior.

Para usar a criptografia em nível de campo do lado do cliente com o driver Java Sync ou Java Reactive Streams, instale a versão 3.10.0 do driver ou posterior. Para usar a API de rotação de chaves, instale mongodb-crypt versão 1.7.3 ou mais tarde.

Para usar a criptografia no nível do campo do lado do cliente com o driver Node.js, instale a versão do driver 3.4.0 ou posterior. Para usar a API de rotação de chaves, instale mongodb-client-encryption versão 2.2.0 - 2.x.

Se você estiver usando a versão 6.0 ou posterior do driver Node.js , também deverá usar a versão 6.0 ou posterior do mongodb-client-encryption.

Para usar a criptografia no nível do campo do lado do cliente e a API de rotação de chaves com o driver PHP, instale a versão 1.6.0 do driver ou posterior.

Para usar a criptografia no nível do campo do lado do cliente com PyMongo, instale a versão do driver 3.10.0 ou posterior. Para usar a API de rotação de chaves, instale o pymongocrypt versão 1.3.1 ou mais tarde.

Para usar a criptografia no nível do campo do lado do cliente e a API de rotação de chaves com o driver Ruby, instale a versão 2.12.1 do driver ou posterior.

Para usar a criptografia em nível de campo do lado do cliente com o driver Rust, instale a versão do driver 2.4.0 ou posterior. Para usar a API de rotação de chaves, instale libmongocrypt versão 1.8.0 ou posterior.

Para usar a criptografia no nível do campo do lado do cliente e a API de rotação de chaves com o driver Scala, instale a versão 2.7.0 do driver ou posterior.