Crear un esquema de cifrado

Crear el esquema de cifrado.

Incluya un encryptedFieldsObject con una matriz fields anidada:

const encryptedFieldsObject = {
   fields: []
}

Especifica los campos a cifrar.

1. Agregue las cadenas path y bsonType a un documento dentro de la matriz de campos:

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

   Importante

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

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

   Importante

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

   Al configurar AutoEncryptionSettings en el cliente, puede utilizar el método auxiliar 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 un almacenamiento óptimos.

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

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

2. Establezca los siguientes campos:

   Campo	Tipo	Descripción
   mín. y máx.	Lo mismo que el campo bsonType	Obligatorio si bsonType es decimal o double. Opcional, pero muy recomendable si es int, long o date. El valor predeterminado son los valores mínimo y máximo de bsonType. Siempre que sea posible, especificar límites en una consulta mejora el rendimiento. Si se consultan valores fuera de estos límites inclusivos, MongoDB devuelve un error.

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

Habilite consultas de prefijo, sufijo o subcadena 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 $encStrStartsWith $encStrNormalizedEq y.

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

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

1. Agregue el objeto queries y establezca queryType en "prefixPreview", "suffixPreview" o "substringPreview":

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

2. Establezca los siguientes campos.

   Para obtener detalles sobre cómo afectan la seguridad y el rendimiento,consulte Configurar campos cifrados para una búsqueda y un 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 realizar consultas.
   strMaxQueryLength	entero	La longitud máxima permitida de prefijo/sufijo/subcadena para consultar. IMPORTANTE: Este ajuste tiene un gran impacto en el rendimiento de las query. Limítalo siempre que sea posible.
   caseSensitive	Booleano	Opcional. Indica si las consultas distinguen entre mayúsculas y minúsculas. El valor predeterminado es true.
   diacriticSensitive	Booleano	Opcional. Indica si las consultas distinguen entre diacríticos. El valor predeterminado es true.

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