(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::createDataKey — Crear un documento clave
$kmsProvider, ?array $options = null): MongoDB\BSON\BinaryCrear un nuevo documento clave e insertarlo en la colección de claves.
kmsProvider
El proveedor KMS (por ejemplo "local",
"aws") que se utilizará para cifrar el nuevo documento clave.
options
| Opción | Tipo | Descripción | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| masterKey | array |
El documento masterKey identifica una clave específica de KMS utilizada para
cifrar el nuevo documento clave. Esta opción es requerida a menos que
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| keyAltNames | array |
Una lista opcional de nombres alternativos de string utilizados para referenciar una clave.
Si una clave se crea con nombres alternativos, entonces el cifrado puede referirse
a la clave por el nombre alternativo único en lugar de por
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| keyMaterial | MongoDB\BSON\Binary |
Un valor opcional de 96 bytes a utilizar como material de clave para el documento clave en curso de creación. Si keyMaterial es dado, el material de clave personalizado se utiliza para cifrar y descifrar los datos. De lo contrario, el material de clave para el nuevo documento clave es generado a partir de un dispositivo aleatorio criptográficamente seguro. |
Devuelve un identificador del nuevo documento clave como un objeto MongoDB\BSON\Binary con el subtipo 4 (UUID).
| Versión | Descripción |
|---|---|
| PECL mongodb 1.20.0 |
Adición de "delegated" a las opciones masterKey del proveedor KMIP.
|
| PECL mongodb 1.15.0 |
Adición de la opción "keyMaterial".
|
| PECL mongodb 1.10.0 | Azure y GCP son ahora soportados como proveedores KMS para el cifrado lado-cliente. |