CSFLE 兼容性

本页介绍了与客户端字段级加密兼容的 MongoDB 和驱动程序版本。

➤ 使用选择语言下拉菜单选择您的驱动程序，并查看其与客户端字段级加密的兼容性。

MongoDB 版本和版本兼容性

使用Client-Side 字段级加密的自动加密仅适用于 MongoDB Enterprise 4.2 或更高版本。

MongoDB Community 和企业版 4.2 或更高版本提供使用客户端 Field Level Encryption 的显式加密。

驱动程序兼容性

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

要通过.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>

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

要将客户端字段级加密与 Java Reactive Streams 驱动程序结合使用，请安装驱动程序版本 1.12.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 或更高版本。

要了解有关 Key Rotation API 的更多信息，请参阅轮换加密密钥。