对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

安装和配置 CSFLE 查询分析组件

MongoDB使用自动加密共享库(推荐)或 mongocryptd 可执行进程将查询转换为加密查询,并加密或解密数据。

要将 CSFLE 与自动加密结合使用,必须首先选择希望MongoDB用于加密字段的查询分析组件。

libmongocrypt 库和MongoDB驱动程序需要自动加密共享库或 mongocryptd 来解释加密的查询。有关更多信息,请参阅为 CSFLE 安装 libmongocrypt。

自动加密共享库是一个动态库,使您的客户端应用程序能够执行自动加密。 动态库是应用程序在运行时而不是编译时访问的一设立功能。 自动加密共享库执行以下任务:

  • 读取加密模式以确定要加密或解密的字段

  • 防止应用程序对加密字段执行不支持的操作

自动加密共享库不 执行任何以下操作:

  • 进行数据加密或解密

  • 访问加密密钥材料

  • 在网络上侦听数据

自动加密共享库是 mongocryptd 的首选替代方案,并且不要求您生成另一个进程以执行自动加密。

注意

虽然我们建议使用自动加密共享库,但仍支持 mongocryptd。

要学习;了解有关自动加密的更多信息,请参阅 CSFLE 功能。

mongocryptd 随MongoDB Enterprise Server 一起安装。

当您创建启用了 CSFLE 的 MongoDB 客户端时,默认情况下会自动启动mongocryptd进程。

mongocryptd 进程:

  • 使用指定的自动加密规则对读写操作中的字段进行标记,以便加密。

  • 防止在加密字段上执行不支持的操作。

  • 分析为数据库连接指定的加密模式。自动加密规则使用严格的 JSON Schema 语法子集。如果规则包含无效的自动加密语法或任何 schema validation 语法,mongocryptd 将返回错误。

mongocryptd 仅执行上述功能,不执行以下任何操作:

  • mongocryptd 不进行加密或解密

  • mongocryptd 不访问任何加密密钥材料

  • mongocryptd 不监听网络

为了执行字段加密和自动解密,驱动程序使用 Apache 许可的libmongocrypt库。

官方MongoDB驱动程序需要访问权限客户端托管上的 mongocryptd进程。这些客户端默认在系统 PATH 中搜索mongocryptd进程。

1

从 MongoDB 下载中心下载自动加密共享库,方法是先选择版本和平台,然后选择库:

  1. 在Version下拉列表中,选择标记为“当前”的版本。

  2. 在 Platform 下拉列表中,选择您的平台。

  3. 在 Package 下拉菜单中,选择 crypt_shared。

  4. 单击 Download(连接)。

提示

要查看可用版本和软件包的扩展列表,请参阅MongoDB Enterprise 下载。

2

您可以通过以下参数,配置驱动程序搜索自动加密共享库的方式:

名称
说明

cryptSharedLibPath

指定自动加密共享库包crypt_shared的绝对路径。

默认:undefined。

cryptSharedLibRequired

指定驱动程序是否必须使用自动加密共享库。如果为 true,则当自动加密共享库不可用时,驱动程序会引发错误。如果为 false,驱动程序将执行以下操作序列:

  1. 尝试使用自动加密共享库。

  2. 如果自动加密共享库不可用,则驱动程序尝试生成并连接到 mongocryptd。

默认:false。

要查看说明如何配置这些参数的示例,请参阅快速入门。

选择您的语言
给本页内容打分

在此页面上