Crear un esquema de cifrado

Crear el esquema de cifrado.

Incluye un encryptedFieldsObject con un fields arreglo:

const encryptedFieldsObject = {
   fields: []
}

Especifica los campos a cifrar.

1. Agregue las cadenas path y bsonType a un documento dentro del arreglo de campos:

   const encryptedFieldsObject = {
      fields: [
         {
            path: "myDocumentField",
            bsonType: "int"
         }
      ]
   }

   Importante

   Puedes especificar cualquier campo para el cifrado excepto el campo _id.

2. Opcionalmente, establece un campo keyId con el ID DEK.

   Importante

   Los ID de clave deben ser únicos, de lo contrario, el servidor devuelve un error.

   Al configurar AutoEncryptionSettings en el cliente, puedes utilizar el método asistente createEncryptedCollection para crear claves automáticamente.

   {
      path: "myDocumentField",
      bsonType: "int",
      keyId: "<unique data encryption key>"
   }

Habilitar consultas de igualdad en los campos deseados.

Esto permite realizar consultas con los $eq $ne$inoperadores,,$nin y.

Agregue el objeto queries y establezca queryType en "equality":

{
   path: "myDocumentField",
   bsonType: "int",
   queries: { queryType: "equality" }
}

Habilitar consultas de rango en los campos deseados.

Esto permite realizar consultas con los $lt $lte$gtoperadores,,$gte y.

Para obtener detalles sobre cómo las siguientes opciones afectan la seguridad y el rendimiento, consulte Configurar campos cifrados para una búsqueda y almacenamiento óptimos.

1. Agregue el objeto queries y establezca queryType en "range":

   {
      path: "myDocumentRangeField",
      bsonType: "int",
      queries: { queryType: "range" }
   }

2. Configura los siguientes campos:

   Campo	Tipo	Descripción
   mín. y máx.	Igual que campo bsonType	Obligatorio si bsonType es decimal o double. Opcional pero muy recomendable si es int, long o date. Por defecto, se establecen en los valores mínimos y máximos del bsonType. Cuando sea posible, especificar límites en una query mejora el rendimiento. Si consulta valores fuera de estos límites inclusivos, MongoDB devuelve un error.

   {
      path: "myDocumentRangeField",
      bsonType: "int",
      queries: { queryType: "range",
                 min: 0,
                 max: 1200
      }
   }

Activa las consultas de prefijos, sufijos o subcadenas en los campos deseados.

Estos tipos de consulta son solo para los campos string. Puede habilitar prefixPreview y suffixPreview en el mismo campo, pero no podrá habilitar ninguno si usa substringPreview.

• prefixPreview las consultas habilitan las expresiones de agregación de $encStrStartsWith y $encStrNormalizedEq.

• suffixPreview las consultas habilitan las expresiones de agregación de $encStrEndsWith y $encStrNormalizedEq.

• substringPreview las consultas habilitan las expresiones de agregación de $encStrContains y $encStrNormalizedEq.

1. Agrega el objeto queries y define queryType como "prefixPreview", "suffixPreview" o "substringPreview":

   {
      path: "myDocumentStringField",
      bsonType: "string",
      queries: { queryType: "substringPreview" }
   }

2. Configura los siguientes campos.

   Para obtener detalles sobre cómo afectan la seguridad y el rendimiento, consulta Configurar campos cifrados para búsqueda y almacenamiento óptimos.

   Campo	Tipo	Descripción
   strMaxLength	entero	substringPreview solo queries. La longitud máxima permitida para un campo indexado por subcadena.
   strMinQueryLength	entero	La longitud mínima permitida de prefijo/sufijo/subcadena para query.
   strMaxQueryLength	entero	La longitud máxima permitida de prefijo/sufijo/subcadena para query. IMPORTANTE: Este ajuste tiene un gran impacto en el rendimiento de las query. Limítalo siempre que sea posible.
   caseSensitive	Booleano	opcional. Si las consultas distinguen entre mayúsculas y minúsculas. Por defecto true.
   diacriticSensitive	Booleano	opcional. Si las búsquedas son sensibles a los signos diacríticos. Por defecto true.

   {
      path: "myDocumentStringField",
      bsonType: "string",
      queries: {
         "queryType": "substringPreview",
         "strMaxLength": 30,
         "strMinQueryLength": 1,
         "strMaxQueryLength": 20,
         "caseSensitive": false
      }
   }