用于 Queryable Encryption 的 MongoClient 选项

Overview

在此页面上，您可以学习；了解MongoClient实例的Queryable Encryption特定配置选项。

自动加密选项

下表显示了 AutoEncryptionOptions 对象的结构：

属性	数据类型	必需？	说明
`keyVaultNamespace`	`String`	是	密钥保管库集合的完整命名空间。
`kmsProviders`	`Object`	是	Queryable Encryption用于管理客户数主密钥 (CMK) 的密钥管理系统 ( KMS )。要学习；了解有关`kmsProviders`对象的详情，请参阅KMS提供程序。要学习；了解有关客户数主密钥的更多信息，请参阅加密密钥和密钥保管库。
`bypassAutoEncryption`	`Boolean`	No	指定`true`可绕过自动加密规则并对每个字段执行显式（手动）加密。
`bypassQueryAnalysis`	`Boolean`	No	禁用对传出命令的自动分析。指定`true`以使用显式加密，而不使用自动加密共享库。
`encryptedFieldsMap`	`Object`	No	一种模式，用于指定要自动加密的字段以及允许对这些字段进行的查询类型。要学习；了解如何构建加密模式，请参阅加密字段和启用查询。
`explicitEncryptionOnly`	`Boolean`	No	如果将 `explicitEncryptionOnly`设立为 `true`，则驱动程序仅对每个字段使用显式（手动）加密，并从连接中删除自动加密设置。您必须使用 `ClientEncryption` API手动加密和解密字段值。此选项仅适用于 CSFLE。
`keyVaultClient`	`MongoClient`	No	指定应连接到托管密钥保管库集合的MongoDB实例的`MongoClient` 。如果省略此选项，驱动程序将使用当前的`MongoClient`实例。要学习；了解有关密钥保管库集合的更多信息，请参阅密钥保管库集合。
`tlsOptions`	`Object`	No	连接到KMS提供商时使用的 TLS 选项。

下表描述了AutoEncryptionOptions对象中的属性：

属性	数据类型	必需？	说明
`KeyVaultNamespace`	`CollectionNamespace`	是	密钥保管库集合的完整命名空间。
`KmsProviders`	`IReadOnlyDictionary`	是	Queryable Encryption用于管理客户数主密钥 (CMK) 的密钥管理系统 ( KMS )。要学习；了解有关`KmsProviders`对象的详情，请参阅KMS提供程序。要学习；了解有关客户数主密钥的更多信息，请参阅加密密钥和密钥保管库。
`BypassAutoEncryption`	`Boolean`	No	指定`true`可绕过自动加密规则并对每个字段执行显式（手动）加密。
`BypassQueryAnalysis`	`Boolean`	No	禁用对传出命令的自动分析。将此属性设置为`true`可使用显式加密，而不使用自动加密共享库。
`EncryptedFieldsMap`	`IReadOnlyDictionary`	No	一种模式，用于指定要自动加密的字段以及允许对这些字段进行的查询类型。要学习；了解如何构建加密模式，请参阅加密字段和启用查询。
`ExtraOptions`	`IReadOnlyDictionary`	No	加密库的配置选项。要使用自动加密共享库而不是`mongocryptd` ，请在`cryptSharedLibPath`属性中指定库文件的完整绝对或相对文件路径。如果驱动程序无法从此路径加载自动加密共享库，则创建 `MongoClient` 将失败。
`KeyVaultClient`	`IMongoClient`	No	指定应连接到托管密钥保管库集合的MongoDB实例的`MongoClient` 。如果省略此选项，驱动程序将使用当前的`MongoClient`实例。要学习；了解有关密钥保管库集合的更多信息，请参阅密钥保管库集合。
`TlsOptions`	`IReadOnlyDictionary`	No	连接到KMS提供商时使用的 TLS 选项。

注意

API 文档

有关这些自动加密选项的更多信息，请参阅 AutoEncryptionOptions 类的API文档。

下表描述了AutoEncryptionOptions对象中的选项：

选项	数据类型	必需？	说明
`KeyVaultNamespace`	`String`	是	密钥保管库集合的完整命名空间。
`KmsProviders`	`map[string]map[string]interface{}`	是	Queryable Encryption用于管理客户数主密钥 (CMK) 的密钥管理系统 ( KMS )。要学习；了解有关`KmsProviders`对象的详情，请参阅KMS提供程序。要学习；了解有关客户数主密钥的更多信息，请参阅加密密钥和密钥保管库。
`BypassAutoEncryption`	`*bool`	No	指定`true`可绕过自动加密规则并对每个字段执行显式（手动）加密。
`BypassQueryAnalysis`	`*bool`	No	禁用对传出命令的自动分析。指定`true`以使用显式加密，而不使用自动加密共享库。
`EncryptedFieldsMap`	`map[string]interface{}`	No	一种模式，用于指定要自动加密的字段以及允许对这些字段进行的查询类型。要学习；了解如何构建加密模式，请参阅加密字段和启用查询。
`ExtraOptions`	`map[string]interface{}`	No	加密库的配置选项。要使用自动加密共享库而不是`mongocryptd` ，请在`cryptSharedLibPath`属性中指定库文件的完整绝对或相对文件路径。如果驱动程序无法从此路径加载自动加密共享库，则创建 `MongoClient` 将失败。
`KeyVaultClientOptions`	`*ClientOptions`	No	用于连接到托管密钥保管库集合的MongoDB实例的新内部`mongo.Client`的选项。如果省略此选项，驱动程序将使用当前的`MongoClient`实例。要学习；了解有关密钥保管库集合的更多信息，请参阅密钥保管库集合。
`TlsConfig`	`map[string]*tls.Config`	No	连接到KMS提供商时使用的 TLS 选项。

注意

API 文档

有关这些自动加密选项的更多信息，请参阅AutoEncryptionOptions类型的API文档。

下表描述了AutoEncryptionSettings构建器上可用的方法：

方法	数据类型	必需？	说明
`keyVaultNamespace`	`String`	是	密钥保管库集合的完整命名空间。
`kmsProviders`	`Map`	是	Queryable Encryption用于管理客户数主密钥 (CMK) 的密钥管理系统 ( KMS )。要学习；了解有关`kmsProviders`对象的详情，请参阅KMS提供程序。要学习；了解有关客户数主密钥的更多信息，请参阅加密密钥和密钥保管库。
`bypassAutoEncryption`	`Boolean`	No	指定`true`可绕过自动加密规则并对每个字段执行显式（手动）加密。
`bypassQueryAnalysis`	`Boolean`	No	禁用对传出命令的自动分析。指定`true`以使用显式加密，而不使用自动加密共享库。
`encryptedFieldsMap`	`Map`	No	一种模式，用于指定要自动加密的字段以及允许对这些字段进行的查询类型。要学习；了解如何构建加密模式，请参阅加密字段和启用查询。
`extraOptions`	`Map`	No	加密库的配置选项。要使用自动加密共享库而不是`mongocryptd` ，请在`cryptSharedLibPath`属性中指定库文件的完整绝对或相对文件路径。
`keyVaultMongoClientSettings`	`MongoClientSettings`	No	用于连接到托管密钥保管库集合的MongoDB实例的新`MongoClient`实例的设置。如果省略此选项，驱动程序将使用当前的`MongoClient`实例。要学习；了解有关密钥保管库集合的更多信息，请参阅密钥保管库集合。
`kmsProviderPropertySuppliers`	`Map`	No	与`kmsProviders()`方法类似，但为每个属性配置一个`Supplier` 。
`kmsProviderSslContextMap`	`Map`	No	用于身份验证的 SSL 上下文。

注意

API 文档

有关这些自动加密选项的更多信息，请参阅 AutoEncryptionSettings.Builder 类的API文档。

下表显示了 AutoEncryptionOptions 对象的结构：

属性	数据类型	必需？	说明
`keyVaultNamespace`	`String`	是	密钥保管库集合的完整命名空间。
`kmsProviders`	`Object`	是	Queryable Encryption用于管理客户数主密钥 (CMK) 的密钥管理系统 ( KMS )。要学习；了解有关`kmsProviders`对象的详情，请参阅KMS提供程序。要学习；了解有关客户数主密钥的更多信息，请参阅加密密钥和密钥保管库。
`bypassAutoEncryption`	`Boolean`	No	指定`true`可绕过自动加密规则并对每个字段执行显式（手动）加密。
`bypassQueryAnalysis`	`Boolean`	No	禁用对传出命令的自动分析。指定`true`以使用显式加密，而不使用自动加密共享库。如果未指定，则默认为`false` 。
`encryptedFieldsMap`	`Object`	No	一种模式，用于指定要自动加密的字段以及允许对这些字段进行的查询类型。要学习；了解如何构建加密模式，请参阅加密字段和启用查询。
`extraOptions`	`Object`	No	加密库的配置选项。要使用自动加密共享库而不是`mongocryptd` ，请在此对象的`cryptSharedLibPath`属性中指定库文件的完整绝对或相对文件路径。如果驱动程序无法从此路径加载自动加密共享库，则创建 `MongoClient` 将失败。
`keyVaultClient`	`MongoClient`	No	指定应连接到托管密钥保管库集合的MongoDB实例的`MongoClient` 。如果省略此选项，驱动程序将使用当前的`MongoClient`实例。要学习；了解有关密钥保管库集合的更多信息，请参阅密钥保管库集合。
`tlsOptions`	`Object`	No	连接到KMS提供商时使用的 TLS 选项。

注意

API 文档

有关这些自动加密选项的更多信息，请参阅 AutoEncryptionOptions 接口的API文档。

下表描述了AutoEncryptionOpts类的参数：

Parameter	数据类型	必需？	说明
`key_vault_namespace`	`String`	是	密钥保管库集合的完整命名空间。
`kms_providers`	`Mapping[string, Any]`	是	Queryable Encryption用于管理客户数主密钥 (CMK) 的密钥管理系统 ( KMS )。要学习；了解有关`kms_Providers`地图的详情，请参阅KMS提供程序。要学习；了解有关客户数主密钥的更多信息，请参阅加密密钥和密钥保管库。
`bypass_auto_encryption`	`Boolean`	No	指定`True`可绕过自动加密规则并对每个字段执行显式（手动）加密。
`bypass_query_analysis`	`Boolean`	No	禁用对传出命令的自动分析。指定`True`以使用显式加密，而不使用自动加密共享库。
`encrypted_fields_map`	`Mapping`	No	一种模式，用于指定要自动加密的字段以及允许对这些字段进行的查询类型。要学习；了解如何构建加密模式，请参阅加密字段和启用查询。
`crypt_shared_lib_path`	`String`	No	在此参数中指定库文件的完整绝对或相对文件路径，以使用自动加密共享库，而不是`mongocryptd` ，如果驱动程序无法从此路径加载自动加密共享库，则会引发错误。
`crypt_shared_lib_required`	`Boolean`	No	如果您指定 `True`，则当 `libmongocrypt` 无法加载自动加密共享库时，驱动程序会引发错误。
`key_vault_client`	`MongoClient`	No	指定应连接到托管密钥保管库集合的MongoDB实例的`MongoClient` 。如果省略此选项，驱动程序将使用当前的`MongoClient`实例。要学习；了解有关密钥保管库集合的更多信息，请参阅密钥保管库集合。
`kms_tls_options`	`Mapping[string, Any]`	No	连接到KMS提供商时使用的 TLS 选项。
`mongocryptd_uri`	`String`	No	用于连接到本地`mongocryptd`进程的MongoDB URI（如果使用`mongocryptd`进行加密）。
`mongocryptd_bypass_spawn`	`Boolean`	No	如果您为此参数指定`True` ，并且使用`mongocryptd`进行加密，则加密的`MongoClient`不会尝试生成`mongocryptd`进程。
`mongocryptd_spawn_path`	`String`	No	如果使用`mongocryptd`进行加密，则用于生成`mongocryptd`进程。
`mongocryptd_spawn_args`	`String`	No	如果使用 `mongocryptd` 进行加密，则生成 `mongocryptd`进程时要使用的string参数列表。

注意

API 文档

有关这些自动加密选项的更多信息，请参阅 AutoEncryptionOpts 类的API文档。

后退

支持的操作

来年

客户端字段级加密 (Client-Side Field Level Encryption)