(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::createDataKey — Create a new encryption data key
$kmsProvider, array $options = ?): MongoDB\BSON\BinaryCreates a new key document and inserts it into the key vault collection.
kmsProvider
The KMS provider (e.g. "local",
"aws", "azure",
"gcp") that will be used to encrypt the new encryption
key.
options
| Option | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| masterKey | array |
The masterKey identifies a KMS-specific key used to encrypt the new
data key. This option is required unless
If
If
If
|
|||||||||||||||||||||||||||||||||||||||||||||
| keyAltNames | array |
An optional list of string alternate names used to reference a key.
If a key is created with alternate names, then encryption may refer
to the key by the unique alternate name instead of by
|
Returns the identifier of the new key as a MongoDB\BSON\Binary object with subtype 4 (UUID).
| Version | Description |
|---|---|
| PECL mongodb 1.10.0 | Azure and GCP are now supported as KMS providers for client-side encryption. |