暗号化する値
データ暗号化キーの ID
アルゴリズム
- unindexed: クエリ不可の暗号化フィールドの場合。
- indexed: は等価クエリをサポートします。
- range: 範囲クエリをサポートします。
- string: はプレフィックス、サフィックス、サブストリングのクエリをサポートします。
選択したアルゴリズムのパラメータ。明示的な暗号化では暗号化スキーマが使用されないため、読み取り操作と書込み操作の両方で、encrypt を呼び出すたびにこれらのパラメータを渡す必要があります。
読み取り操作では、指定されたアルゴリズムと一致する queryType を指定する必要があります。

注意

indexedrange、、string encryptedFieldsdb.createCollection()アルゴリズムでは、サーバー上にインデックスが必要です。このインデックスは、中にオプションを指定したときに作成されます。

アルゴリズムとクエリの種類

アルゴリズム	queryType（読み取り操作）	追加のパラメーター
`indexed`	`equality`	（必須）競合係数
`range`	`range`	（必須）競合係数（精度を設定する場合は必須です。それ以外は任意ですが推奨）クエリ可能な最大値（任意。`double` と`decimal` フィールドのみで使用）の精度（任意）trimFactor （任意）スパース度
`string`	`prefix` or `suffix`	（必須）競合係数（必須）大文字と小文字を区別する、発音区別符号を区別する（必須） strMinQueryLength、strMaxQueryLength
`string`	`substring`	（必須）競合係数（必須）大文字と小文字を区別する、発音区別符号を区別する（必須） strMinQueryLength、strMaxQueryLength （必須） strMaxLength

書込み操作では、同じ呼び出しで prefix オプションと suffix オプションを指定して、両方のクエリタイプのフィールドをインデックスできます。 prefix または suffix と一緒に substring を設定することはできません。

注意

MongoDB 9.0 以降、textアルゴリズムを使用する prefixPreview、suffixPreview、substringPreview クエリタイプは非推奨となり、削除されました。代わりに、stringアルゴリズムで prefix、suffix、または substring クエリタイプを使用してください。

自動復号化

フィールドを自動的に復号化するには、 MongoClientインスタンスを次のように構成します。

kmsProvidersオブジェクトを指定する
キーヴォールトコレクションを指定する
MongoDB Community Server を使用する場合は、 bypassQueryAnalysisオプションをTrueに設定します

注意

MongoDB Community Server での自動復号化

MongoDB Community Server では自動復号化が利用できます。自動暗号化には MongoDB Enterprise または MongoDB Atlas が必要です。

サーバー側のフィールドレベル暗号化の強制

コレクション内の特定のフィールドの暗号化を強制する手順。

MongoDBインスタンスが特定のフィールドの暗号化を強制する場合、明示的な暗号化化を使用してQueryable Encryptionを実行するクライアントは、指定されたようにそれらのフィールドを暗号化する必要があります。サーバー側でのQueryable Encryptionの設定方法については、「暗号化されたフィールド」と「有効なクエリ」を参照してください。

詳細

キーヴォールトコレクション、データ暗号化キー、カスタマーマスターキーの詳細については、「暗号化キーとキーヴォールト」を参照してください。

KMS プロバイダーとkmsProviders オブジェクトの詳細については、「 KMS プロバイダー」を参照してください。

戻る

コレクション

キーの管理