(mongodb >=1.7.0)
MongoDB\Driver\Manager::createClientEncryption — Crear un nuevo objeto ClientEncryption
$options): MongoDB\Driver\ClientEncryptionConstruye un nuevo objeto MongoDB\Driver\ClientEncryption con las opciones especificadas.
options
| Option | Type | Description |
|---|---|---|
| keyVaultClient | MongoDB\Driver\Manager | El Manager utilizado para enrutar las peticiones de claves de datos a un cluster MongoDB diferente. Por omisión, el Manager y cluster actual es utilizado. |
| keyVaultNamespace | string | Un nombre de espacio completamente calificado (por ejemplo "databaseName.collectionName") denotando la colección que contiene todas las claves de datos utilizadas para el cifrado y descifrado. Esta opción es requerida. |
| kmsProviders | array |
Un documento que contiene la configuración de uno o varios
proveedores KMS, que se utilizan para cifrar las claves de datos.
Los proveedores soportados son
Si se especifica un documento vacío para
El formato para aws: {
accessKeyId: <string>,
secretAccessKey: <string>,
sessionToken: <optional string>
}
El formato para azure: {
tenantId: <string>,
clientId: <string>,
clientSecret: <string>,
identityPlatformEndpoint: <optional string> // Defaults to "login.microsoftonline.com"
}
El formato para gcp: {
email: <string>,
privateKey: <base64 string>|<MongoDB\BSON\Binary>,
endpoint: <optional string> // Defaults to "oauth2.googleapis.com"
}
El formato para kmip: {
endpoint: <string>
}
El formato para local: {
// 96-byte master key used to encrypt/decrypt data keys
key: <base64 string>|<MongoDB\BSON\Binary>
}
|
| tlsOptions | array |
Un documento que contiene la configuración TLS de uno o varios
proveedores KMS.
Los proveedores soportados son <provider>: {
tlsCaFile: <optional string>,
tlsCertificateKeyFile: <optional string>,
tlsCertificateKeyFilePassword: <optional string>,
tlsDisableOCSPEndpointCheck: <optional bool>
}
|
Devuelve una nueva instancia de MongoDB\Driver\ClientEncryption.
| Versión | Descripción |
|---|---|
| PECL mongodb 1.16.0 |
El proveedor AWS KMS para el cifrado del lado del cliente acepta
ahora una opción
Añadido
Si se especifica un documento vacío para el proveedor KMS |
| PECL mongodb 1.15.0 |
Si se especifica un documento vacío para el proveedor KMS |
| PECL mongodb 1.12.0 |
KMIP es ahora soportado como proveedor KMS para el cifrado
del lado del cliente y puede ser configurado en la opción
Añadida la opción |
| PECL mongodb 1.10.0 |
Azure y GCP son ahora soportados como proveedores KMS para el cifrado
del lado del cliente y pueden ser configurados en la opción
|