Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

cifrado a nivel de campo

Cuando trabajes con un clúster de MongoDB Enterprise o MongoDB Atlas, puedes utilizar mongosh para configurar Queryable Encryption o Cifrado a nivel de campo del lado del cliente y conectarte con soporte para cifrado. Tanto la encriptación Queryable Encryption como CSFLE utilizan claves de encriptación de datos para permitir la encriptación y desencriptación de los valores de los campos y almacenan el material de la clave de encriptación en un Key Management Service (KMS).

mongosh soporta los siguientes proveedores de KMS para su uso con Queryable Encryption y CSFLE:

  • Amazon Web Services KMS

  • Azure Key Vault

  • Google Cloud Platform KMS

  • Archivo clave gestionado localmente

El siguiente procedimiento utiliza mongosh para crear una llave de cifrado de datos para encriptación a nivel de campo.

Utiliza las pestañas de abajo para seleccionar el KMS adecuado para tu implementación:

1

Cree una sesión de mongosh sin conectarse a una base de datos en ejecución usando la opción --nodb:

mongosh --nodb
2

Configurar el cifrado a nivel de campo en el lado del cliente para el AWS KMS requiere un AWS Access Key ID y su correspondiente Secret Access Key. La clave de acceso de AWS debe corresponder a un usuario de IAM con todos los permisos de listar y leer para el servicio KMS.

En mongosh, cree una nueva variable AutoEncryptionOpts para almacenar la configuración de cifrado a nivel de campo del lado del cliente, que contiene estas credenciales:

var autoEncryptionOpts = { "keyVaultNamespace" : "encryption.__dataKeys", "kmsProviders" : { "aws" : { "accessKeyId" : "YOUR_AWS_ACCESS_KEY_ID", "secretAccessKey" : "YOUR_AWS_SECRET_ACCESS_KEY" } }}

Completa los valores de YOUR_AWS_ACCESS_KEY_ID y YOUR_AWS_SECRET_ACCESS_KEY según corresponda.

3

En mongosh, utiliza el constructor Mongo() para establecer una conexión de base de datos con el clúster objetivo. Especifica el documento AutoEncryptionOpts como el segundo parámetro del constructor Mongo() para configurar la conexión para el cifrado a nivel de campo del lado del cliente:

csfleDatabaseConnection = Mongo( "mongodb://replaceMe.example.net:27017/?replicaSet=myMongoCluster", autoEncryptionOpts)

Reemplazar el replaceMe.example.net URI con la cadena de conexión para el clúster de destino.

4

Crea el objeto keyVault utilizando el método de shell getKeyVault():

keyVault = csfleDatabaseConnection.getKeyVault();
5

Crea la clave de cifrado de datos utilizando el método shell createKey() :

keyVault.createKey( "aws", { region: "regionname", key: "awsarn" }, [ "keyAlternateName" ])

Dónde:

  • El primer parámetro debe ser "aws" para especificar el Amazon Web Services KMS configurado.

  • El segundo parámetro debe ser un documento que contenga lo siguiente:

  • El tercer parámetro puede ser un arreglo de uno o más keyAltNames para la llave de cifrado de datos. Cada nombre alternativo de clave debe ser único. getKeyVault() crea un índice único en keyAltNames para aplicar la unicidad en el campo, si aún no existe. Los nombres alternativos de claves facilitan la localización de la clave de cifrado de datos.

Si tiene éxito, createKey() devuelve el UUID de la nueva clave de cifrado de datos. Para recuperar el nuevo documento de clave de cifrado de datos del almacén de claves, puede:

  • Utilice getKey() para recuperar la clave creada por su UUID, o

  • Utilice getKeyByAltName() para recuperar la clave por su nombre alternativo, si se especifica.

Califique esta página