兼容性

要将客户端字段级加密和密钥轮换 API 与 C 驱动程序一起使用，请安装驱动程序版本 1.17.5 或更高版本。

要将客户端字段级加密和密钥轮换 API 与 C++ 驱动程序结合使用，请安装驱动程序版本 3.6.0 或更高版本。

要通过.NET/C#驱动程序使用客户端字段级加密，请安装驱动程序版本 2.10.0 或更高版本。要使用密钥轮换 API，请安装驱动程序版本 2.17.1 或更高版本。

如果您使用的是驾驶员版本 3.0 或更高版本：

• 安装MongoDB。来自 NuGet 的驱动程序.Encryption包。该包支持自动加密。

• 如果您的应用程序在Linux上运行，请手动安装 libmongocrypt。然后，将 LIBMONGOCRYPT_PATH环境变量设立为libmongocrypt 文件的绝对路径。

• 如果您的应用程序在 64 位Linux上运行，并且您使用的是 3.4.3 或更早版本的驾驶员程序，请将以下 XML 添加到 .csproj文件中。

  将 <MongoDriverEncryptionVersion> 替换为已安装的 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>

要通过Go驱动程序使用客户端字段级加密，请安装驱动程序版本 1.2 或更高版本。要使用密钥轮换API，请安装 libmongocrypt 1.5.2 或更高版本。

要将客户端字段级加密与 Java Reactive Streams 驱动程序结合使用，请安装驱动程序版本 1.12.0 或更高版本。要使用密钥轮换 API，请安装 mongodb-crypt 版本 1.7.3 或更高版本。

要将客户端字段级加密与Java 同步或Java Reactive Streams驱动程序一起使用，请安装驱动程序版本 3.10.0 或更高版本。要使用密钥轮换 API，请安装 mongodb-crypt 版本 1。7。3或更高版本。

要通过 Node.js 驱动程序使用客户端字段级加密，请安装驱动程序版本 3.4.0 或更高版本。要使用密钥轮换API，请安装 mongodb-client-encryption 版本 2.2.0- 2.x。

如果您使用的是 6.0 或更高版本的 Node.js 驱动程序，则还必须使用 mongodb-client-encryption 6.0 或更高版本。

要将客户端字段级加密和密钥轮换API与PHP驱动程序结合使用，请安装驱动程序版本 1.6.0 或更高版本。

要在PyMongo中使用客户端字段级加密，请安装驱动程序版本 3.10.0 或更高版本。要使用密钥轮换API，请安装 pymongocrypt 版本 1。3。1或更高版本。

要将客户端字段级加密和密钥轮换API与Ruby驱动程序结合使用，请安装驱动程序版本 2.12.1 或更高版本。

要将客户端字段级加密与 Rust 驱动程序结合使用，请安装驱动程序版本 2.4.0 或更高版本。要使用密钥轮换 API，请安装 libmongocrypt 版本 1.8.0 或更高版本。

要将客户端字段级加密和密钥轮换 API 与 Scala 驱动程序一起使用，请安装驱动程序版本 2.7.0 或更高版本。