암호화 스키마 만들기

암호화 스키마 만듭니다.

중첩된 fields 배열 과 함께 encryptedFieldsObject 를 포함합니다.

const encryptedFieldsObject = {
   fields: []
}

암호화할 필드를 지정합니다.

1. 필드 배열 내의 문서 에 path 및 bsonType 문자열을 추가합니다.

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

   중요

   _id 필드를 제외한 모든 필드를 암호화하도록 지정할 수 있습니다.

2. 선택 사항으로 keyId 필드 DEK ID 로 설정하다 .

   중요

   키 ID는 고유해야 하며, 그렇지 않으면 서버 오류를 반환합니다.

   클라이언트 에서 AutoEncryptionSettings 를 구성하면 createEncryptedCollection 헬퍼 메서드를 사용하여 키를 자동으로 만들 수 있습니다.

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

원하는 필드에서 동등성 쿼리를 활성화합니다.

이렇게 하면 $eq, $ne, $in 및 $nin 연산자를 사용하여 쿼리할 수 있습니다.

queries 객체 를 추가하고 queryType 을 "equality" 로 설정하다 합니다.

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

원하는 필드에서 범위 쿼리를 활성화합니다.

이렇게 하면 $lt, $lte, $gt 및 $gte 연산자를 사용하여 쿼리할 수 있습니다.

다음 옵션이 보안 및 성능에 미치는 영향에 대한 자세한 내용 은 최적의 검색 및 저장을 위한 암호화된 필드 구성을 참조하세요.

1. queries 객체 를 추가하고 queryType 을 "range" 로 설정하다 합니다.

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

2. 다음 필드를 설정합니다.

   필드	유형	설명
   최소 및 최대	필드 와 동일 bsonType	bsonType 가 decimal 또는 double 인 경우 필수입니다. 선택 사항이지만 int, long 또는 date 인 경우 적극 권장합니다. 기본값은 bsonType 의 최소값과 최대값입니다. 가능한 경우 쿼리 에 범위를 지정하면 성능이 향상됩니다. 이러한 포괄적 범위를 벗어난 값을 쿼리하면 MongoDB 는 오류를 반환합니다.

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

원하는 필드에서 접두사, 접미사 또는 하위 문자열 쿼리를 활성화합니다.

이러한 쿼리 유형은 string 필드에만 적용됩니다. 동일한 필드 에서 prefixPreview 및 suffixPreview 를 모두 활성화 할 수 있지만 substringPreview를 사용하는 경우 둘 다 활성화 할 수 없습니다.

• prefixPreview 쿼리는 $encStrStartsWith 및 $encStrNormalizedEq 집계 표현식을 활성화 .

• suffixPreview 쿼리는 $encStrEndsWith 및 $encStrNormalizedEq 집계 표현식을 활성화 .

• substringPreview 쿼리는 $encStrContains 및 $encStrNormalizedEq 집계 표현식을 활성화 .

1. queries 객체 추가하고 queryType 를 "prefixPreview", "suffixPreview" 또는 "substringPreview"로 설정하다 .

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

2. 다음 필드를 설정합니다.

   보안 및 성능에 미치는 영향에 대한 자세한 내용은 최적의 검색 및 저장을 위한 암호화된 필드 구성을 참조하세요.

   필드	유형	설명
   strMaxLength	integer	substringPreview 쿼리 전용. 하위 문자열 인덱스 필드 에 허용되는 최대 길이입니다.
   strMinQueryLength	integer	쿼리 에 허용되는 최소 접두사/접미사/하위 문자열 길이입니다.
   strMaxQueryLength	integer	쿼리 에 허용되는 최대 접두사/접미사/하위 문자열 길이입니다. 주제: 이 설정은 쿼리 성능에 큰 영향을 미칩니다. 가능하면 제한하세요.
   caseSensitive	부울	선택 사항. 쿼리에서 대소문자를 구분하는지 여부. 기본값은 true입니다.
   diacriticSensitive	부울	선택 사항. 쿼리가 발음 부호를 구분하는지 여부. 기본값은 true입니다.

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