Habilitar el cifrado consultable al crear colecciones

Las consultas de igualdad y rango de cifrado consultable son totalmente compatibles en producción. Las consultas de prefijo, sufijo y subcadena solo están disponibles en la vista previa pública de MongoDB 8.2. No habilite estos tipos de consulta en producción. La funcionalidad de GA de los tipos de consulta de prefijo, sufijo y subcadena será incompatible con la función de vista previa. Para obtener más información, consulte Tipos de consulta admitidos.

Overview

Habilite el cifrado consultable al crear la colección. No puede cifrar campos en documentos que ya estén en una colección.

Importante

Crea tu colección explícitamente, en lugar de hacerlo implícitamente con una operación de inserción. Al crear una colección usando createCollection()MongoDB crea un índice en los campos cifrados. Sin este índice, las consultas en campos cifrados pueden ser lentas.

Habilitar el cifrado consultable en una colección

Puede habilitar el cifrado consultable en los campos de dos maneras. Los siguientes ejemplos usan Node.js para habilitar el cifrado consultable:

Pase el esquema de cifrado, representado por la constante encryptedFieldsObject, al cliente que la aplicación utiliza para crear la colección:

const client = new MongoClient(uri, {
   autoEncryption: {
      keyVaultNameSpace: "<your keyvault namespace>",
      kmsProviders: "<your kms provider>",
      extraOptions: {
         cryptSharedLibPath: "<path to Automatic Encryption Shared Library>"
      },
      encryptedFieldsMap: {
         "<databaseName.collectionName>": { encryptedFieldsObject }
      }
   }
   ...
   await client.db("<database name>").createEncryptedCollection("<collection name>");
}

Para obtener más información sobre las opciones de configuración de autoEncryption, consulte la sección sobre Opciones de MongoClient para cifrado consultable.

Pase el esquema de cifrado encryptedFieldsObject a createEncryptedCollection():
```
await encryptedDB.createEncryptedCollection("<collection name>", {
   encryptedFields: encryptedFieldsObject
});
```
Tip
Especifique encryptedFieldsObject al crear la colección y también al crear un cliente para acceder a ella. Para obtener más información sobre las consideraciones de seguridad al no encryptedFieldsObject definir, consulte Consideraciones de seguridad.

Volver

Crea un esquema

Colecciones