(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::createDataKey — Crea un documento de clave
$kmsProvider, ?array $options = null): MongoDB\BSON\BinaryCrea un nuevo documento de clave e inserta en la colección de almacén de claves.
kmsProvider"local",
"aws") que se utilizará para cifrar la nueva clave de datos.
options
| Opción | Tipo | Descripción | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| masterKey | array |
El documento masterKey identifica una clave específica del KMS utilizada para cifrar
la nueva clave de datos. Esta opción es obligatoria a menos que
kmsProvider sea "local".
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| keyAltNames | array |
Una lista opcional de nombres alternativos de tipo string utilizados para referenciar una clave.
Si se crea una clave con nombres alternativos, entonces el cifrado puede referirse a la clave
mediante el nombre alternativo único en lugar de por _id.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| keyMaterial | MongoDB\BSON\Binary | Un valor opcional de 96 bytes para usar como material de clave personalizado para la clave de datos que se está creando. Si se proporciona keyMaterial, el material de clave personalizado se utiliza para cifrar y descifrar datos. De lo contrario, el material de la nueva clave de datos se genera a partir de un dispositivo criptográficamente seguro aleatorio. |
Devuelve el identificador de la nueva clave como un objeto MongoDB\BSON\Binary con subtipo 4 (UUID).
| Versión | Descripción |
|---|---|
| PECL mongodb 1.20.0 |
Añadido "delegated" a las opciones de masterKey del proveedor KMIP.
|
| PECL mongodb 1.15.0 |
Añadida la opción "keyMaterial".
|
| PECL mongodb 1.10.0 | Azure y GCP ahora son compatibles como proveedores KMS para cifrado lado-cliente. |