暗号化スキーマの作成

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

ネストされた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 フィールドのみで使用されます。同じフィールドで prefix と suffix の両方を有効にできますが、substring を使用する場合はどちらも有効にできません。

• prefix クエリでは、$encStrStartsWith と $encStrNormalizedEq 集計式が有効になります。

• suffix クエリでは、$encStrEndsWith と $encStrNormalizedEq 集計式が有効になります。

• substring クエリでは、$encStrContains と $encStrNormalizedEq 集計式が有効になります。

1. queriesオブジェクトを追加し、queryType を "prefix"、"suffix"、または "substring" に設定します。

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

2. 次のフィールドを設定します。

   セキュリティとパフォーマンスへの影響の詳細については、最適な検索およびストレージ用に暗号化されたフィールドを構成する を参照してください。

   フィールド	タイプ	説明
   strMaxLength	integer	substring クエリのみ。部分文字列インデックスのフィールドに許可される最大長。
   strMinQueryLength	integer	クエリに許可されるプレフィックス/サフィックス/サブストリングの最小長。
   strMaxQueryLength	integer	クエリに許可されるプレフィックス、サフィックス、サブストリングの最大長。 重要: この設定はクエリのパフォーマンスに大きく影響します。可能な場合は常に制限します。
   caseSensitive	ブール値	任意。クエリで大文字と小文字が区別されるかどうか。デフォルトは true です。
   diacriticSensitive	ブール値	任意。クエリが発音区別符号を区別するかどうか。デフォルトは true です。

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