(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. |