Docs 菜单
Docs 主页
/
数据库手册
/
安全性
/
加密
/
正在使用的加密
/
客户端字段级加密 (Client-Side Field Level Encryption)
/
参考

CSFLE 兼容性

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

➤ 使用选择语言下拉菜单选择驾驶员，并查看其与客户端字段级加密的兼容性。

MongoDB 版本和版本兼容性

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

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

驱动程序兼容性

要将客户端字段级加密和密钥轮换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 Sync或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。

要将客户端字段级加密和密钥轮换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 或更高版本。

要学习；了解有关密钥轮换API 的更多信息，请参阅轮换和重新包装加密密钥。

后退

使用 KMIP

来年

CSFLE 限制