(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::createDataKey — Créer un document clé
$kmsProvider
, ?array $options
= null
): MongoDB\BSON\BinaryCréer un nouveau document clé et l'insère dans la collection de coffre de clés.
kmsProvider
Le fournisseur KMS (par exemple "local"
,
"aws"
) qui sera utilisé pour chiffrer le nouveau document clé.
options
Option | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
masterKey | array |
Le document masterKey identifie une clé spécifique à KMS utilisée pour
chiffrer le nouveau document clé. Cette option est requise à moins que
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||
keyAltNames | array |
Une liste optionnelle de noms alternatifs de chaîne utilisés pour référencer une clé.
Si une clé est créée avec des noms alternatifs, alors le chiffrement peut se référer
à la clé par le nom alternatif unique au lieu de par
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||
keyMaterial | MongoDB\BSON\Binary |
Une valeur optionnelle de 96 octets à utiliser comme matériel de clé pour le document clé en cours de création. Si keyMateria est donné, le matériel de clé personnalisé est utilisé pour chiffrer et déchiffrer les données. Sinon, le matériel de clé pour le nouveau document clé est généré à partir d'un dispositif aléatoire cryptographiquement sécurisé. |
Renvoie un identifiant du nouveau document clé en tant qu'objet MongoDB\BSON\Binary avec le sous-type 4 (UUID).
Version | Description |
---|---|
PECL mongodb 1.15.0 |
Ajout de l'option "keyMaterial" .
|
PECL mongodb 1.10.0 | Azure et GCP sont désormais pris en charge en tant que fournisseurs KMS pour le chiffrement côté client. |