MongoDB\Driver\ClientEncryption::createDataKey

参数

kmsProvider

将用于加密新数据密钥的 KMS 提供程序（例如 "local"、"aws"）。

options

数据密钥选项

选项	类型	描述
masterKey	array	masterKey 文档标识用于加密新数据密钥的 KMS 特定密钥。除非 kmsProvider 是 "local"，否则此选项是必需的。 "aws" 提供程序选项 选项 类型 描述 region string 必需。 key string 必需。指向 AWS 客户主密钥 (CMK) 的 Amazon 资源名称 (ARN)。 endpoint string 可选。发送 KMS 请求的备用主机标识符。可能包含端口号。 "azure" 提供程序选项 选项 类型 描述 keyVaultEndpoint string 必需。主机，可选端口（例如“example.vault.azure.net”）。 keyName string 必需。 keyVersion string 可选。命名密钥的特定版本。默认使用密钥的主版本。 "gcp" 提供程序选项 选项 类型 描述 projectId string 必需。 location string 必需。 keyRing string 必需。 keyName string 必需。 keyVersion string 可选。命名密钥的特定版本。默认使用密钥的主版本。 endpoint string 可选。主机，可选端口。默认为“cloudkms.googleapis.com”。 "kmip" 提供程序选项 选项 类型 描述 keyId string 可选。指向 96 字节 KMIP 密钥数据的唯一标识符。如果未指定，驱动程序会创建一个随机的 96 字节 KMIP 密钥数据。 endpoint string 可选。主机，可选端口。
keyAltNames	array	一个可选的字符串别名列表，用于引用密钥。如果密钥使用别名创建，那么加密可以使用唯一的别名代替 _id 来引用密钥。
keyMaterial	MongoDB\BSON\Binary	一个可选的 96 字节值，用作正在创建的数据密钥的自定义密钥材料。如果提供了 keyMaterial，则使用自定义密钥材料来加密和解密数据。否则，新数据密钥的密钥材料将从密码学安全随机设备生成。