db.createEncryptedCollection()（mongoshメソッド）

暗号化された接続の作成

1. mongosh を起動する

   実行:

   mongosh --nodb

   --nodb は、データベースに接続しないことを意味します。

2. キーstringの生成

   基本64 96バイトの string を生成する:

   const TEST_LOCAL_KEY = require("crypto").randomBytes(96).toString("base64")

3. 暗号化オプション オブジェクトの作成

   クライアント側のフィールドレベル暗号化オプションオブジェクトを作成するには、前のステップのTEST_LOCAL_KEY string を使用します。

      var autoEncryptionOpts = {
         "keyVaultNamespace" : "encryption.__dataKeys",
         "kmsProviders" : {
            "local" : {
               "key" : BinData(0, TEST_LOCAL_KEY)
            }
         }
      }

4. 暗号化されたクライアント オブジェクトの作成

   暗号化されたクライアントオブジェクトを作成するには、 Mongo()コンストラクターを使用します。 mongodb://myMongo.example.net URI を、ターゲットクラスターの接続string URIに置き換えます。 （例: ）。

   encryptedClient = Mongo(
      "mongodb://myMongo.example.net:27017/?replSetName=myMongo",
      autoEncryptionOpts
   )

暗号化するフィールドの指定

暗号化するフィールドを指定するには、次のようにencryptedFieldsMapを作成します。

const encryptedFieldsMap = {
  encryptedFields: {
    fields: [
      {
        path: "secretField",
        bsonType: "string",
        queries: { queryType: "equality" },
        // keyId omitted; db.createEncryptedCollection() generates it
      },
    ],
  },
};

暗号化されたコレクションの作成

現在のデータベースのヘルパーを使用して暗号化された enc.usersコレクションを作成します。

const encDb = encryptedClient.getDB("enc");
let result = encDb.createEncryptedCollection(
  "users",
  {
    provider: "local",
    createCollectionOptions: encryptedFieldsMap,
    masterKey: {} // masterKey is optional when provider is local
  }
);

結果オブジェクトを確認する

db.createEncryptedCollection() は、作成されたコレクション名とコレクションの encryptedFields 定義を含む結果オブジェクトを返します。

result.collection の値をチェックして、コレクションが目的のロケーションに作成されていることを確認し、オプションで入力された encryptedFields を検査します。

enc> result.collection
enc.users
enc> result.encryptedFields
{
  fields: [
    {
      path: "secretField",
      bsonType: "string",
      queries: { queryType: "equality", /* ... */ },
      keyId: UUID("...")
    }
  ]
}