暗号化スキーマの作成

暗号化スキーマを作成します。

ネストされたfields配列を持つ encryptedFieldsObjectを含めます。

const encryptedFieldsObject = {
   fields: []
}

暗号化するフィールドを指定します。

1. path文字列とbsonType文字列を フィールド配列内のドキュメントに追加します。

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

   重要

   暗号化には、 _idフィールドを除く任意のフィールドを指定できます。

2. オプションで、DEK IDを使用して keyIdフィールドを設定します。

   重要

   キー 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. 次のフィールドを設定します。

   フィールド	タイプ	説明
   min と max	フィールドと同じ 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
      }
   }