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.

Cómo CSFLE descifra documentos

Esta página describe cómo CSFLE utiliza metadatos de tu llave de cifrado de datos y llave maestra de cliente para descifrar datos.

Cuando cifras datos usando CSFLE, los datos cifrados se almacenan como un objeto de BinData subtipo 6 que incluye los siguientes metadatos:

  • El _id de la llave de cifrado de datos utilizada para cifrar los datos

  • El algoritmo de cifrado utilizado para cifrar los datos

Las llaves de cifrado de datos contienen metadatos que describen qué llave maestra de cliente se utilizó para cifrarlas.

Los controladores y mongosh utilizan estos metadatos para intentar descifrar automáticamente tus datos.

Para descifrar automáticamente tus datos, tu cliente habilitado para CSFLE realiza el siguiente procedimiento:

  1. Verifique los metadatos de blobs BinData del campo que pretende descifrar para la clave de cifrado de datos y el algoritmo de cifrado utilizados para cifrar el valor.

  2. Verifica la Colección de Bóvedas de Llaves configurada en la conexión actual de la base de datos para la llave de cifrado de datos especificada. Si la Colección de Bóvedas de Llaves no contiene la clave especificada, la descifrado automático falla y el driver devuelve un error.

  3. Verifica los metadatos de la llave de cifrado de datos para la llave maestra de cliente (CMK) utilizada para cifrar el material clave.

  4. Descifre la llave de cifrado de datos. Este proceso varía según el proveedor de KMS:

    Para el KMS de Amazon Web Services (AWS), envíe la llave de cifrado de datos a su instancia de KMS de AWS para su descifrado. Si la llave maestra de cliente no existe o si la configuración de la conexión no concede acceso a la llave maestra de cliente, el descifrado falla y el driver devuelve un error.

    Tip

    Para aprender a usar Amazon Web Services KMS para cifrado automático, consulte Use el cifrado automático a nivel de campo del lado del cliente con AWS.

  5. Descifra el valor BinData usando la Llave de cifrado de datos descifrada y el algoritmo adecuado.

Las aplicaciones con acceso al servidor de MongoDB que no también tengan acceso a la CMK requerida y a las claves de cifrado de datos no podrán descifrar los valores de BinData.

Para las operaciones de lectura, el driver cifra los valores de los campos en el documento de query utilizando su esquema de cifrado antes de emitir la operación de lectura.

Tu aplicación cliente utiliza los metadatos de BinData para descifrar automáticamente el documento que recibes de MongoDB.

Para obtener más información sobre los esquemas de cifrado, consulte Esquemas de cifrado.

Para aprender a configurar la conexión a la base de datos para el cifrado a nivel de campo del lado del cliente, consulta Opciones de MongoClient para CSFLE.

Para obtener más información sobre la relación entre las llaves de cifrado de datos y las llaves maestras de cliente, consulta Llaves de cifrado y almacenes de claves.