Docs 菜单
Docs 主页
/ /
客户端字段级加密 (Client-Side Field Level Encryption)
Docs 主页
/
开发中
/
正在使用的加密
/
客户端字段级加密 (Client-Side Field Level Encryption)
Docs 主页
/
开发中
/
正在使用的加密
/
客户端字段级加密 (Client-Side Field Level Encryption)

安装要求

Overview

了解要使用客户端字段级加密 (CSFLE) 必须安装的应用程序和库。

您需要什么

在使用 CSFLE 之前，您必须在开发环境中设置以下项目：

  • （可选）下载自动加密共享库。 自动加密共享库是mongocryptd的首选替代方案，并且不需要生成新进程。 仍支持 mongocryptd 。

  • 安装 MongoDB Enterprise 版。

  • 安装与 CSFLE 兼容的 MongoDB 驱动程序。

  • 启动MongoDB 实例或Atlas 集群。

  • 确保您使用的是 x64 操作系统。CSFLE 需要 x64支持。

如果您使用的是驾驶员版本 3.0 或更高版本，则还必须完成以下步骤：

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

  • 安装 libmongocrypt 。libmongocrypt 库包含用于与管理加密的原生库进行通信的绑定。

  • 安装 mongodb-crypt。mongodb-crypt 库包含用于与管理加密的原生库进行通信的绑定。

  • 安装 mongodb-client-encryption，它是 libmongocrypt加密库的 Node.js 包装器。libmongocrypt 库包含用于与管理加密的原生库通信的绑定。

使用 Node.js 驱动程序版本6.0.0或更高版本时， mongodb-client-encryption必须与驱动程序具有相同的主版本号。

示例，Node.js驾驶员v 6 .xx 需要mongodb-client-encryption v 6 .xx

  • 安装 pymongocrypt，它是 libmongocrypt加密库的Python包装器。libmongocrypt 库包含用于与管理加密的原生库通信的绑定。

了解详情

要开始使用 CSFLE，请参阅 CSFLE 快速入门。

要学习；了解如何将 CSFLE 与远程密钥管理系统提供商结合使用，请参阅 CSFLE 教程。

后退

功能

来年

快速入门

在此页面上