ClientEncryption.encrypt() (mongosh method方法)

Create Your Encrypted Connection创建加密连接

1. Start mongosh

   Run:运行：

   mongosh --nodb

   --nodb means don't connect to a database.意味着不要连接到数据库。

2. Generate a Key String生成键字符串

   Generate a base 64 96-byte string:生成一个基本64 96字节的字符串：

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

3. Create an Encryption Options Object创建加密选项对象

   To create a client-side field level encryption options object, use the TEST_LOCAL_KEY string from the previous step:要创建客户端字段级加密选项对象，请使用上一步中的TEST_LOCAL_KEY字符串：

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

4. Create an Encrypted Client Object创建加密客户端对象

   To create an encrypted client object, use the Mongo() constructor. Replace the mongodb://myMongo.example.net URI with the connection string URI for the target cluster. For example:

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

Encrypt Your Data

Retrieve the ClientEncryption object and use the ClientEncryption.encrypt() method to encrypt a value using a specific data encryption key UUID and encryption algorithm:

clientEncryption = encryptedClient.getClientEncryption();

clientEncryption.encrypt(
  UUID("64e2d87d-f168-493c-bbdf-a394535a2cb9"),
  "123-45-6789",
  "AEAD_AES_256_CBC_HMAC_SHA_512-Random"
)

You can also specify the algorithm using a document with an algorithm field:

clientEncryption = encryptedClient.getClientEncryption();

clientEncryption.encrypt(
  UUID("64e2d87d-f168-493c-bbdf-a394535a2cb9"),
  "123-45-6789",
  { algorithm: "AEAD_AES_256_CBC_HMAC_SHA_512-Random" }
)

Create Your Encrypted Connection

1. Start mongosh

   Start the mongosh client.

   mongosh --nodb

2. Generate Your Key

   To configure Queryable Encryption for a locally managed key, generate a base64-encoded 96-byte string with no line breaks.要为本地管理的键配置可查询加密，请生成一个没有换行符的base64编码的96字节字符串。

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

3. Create the Queryable Encryption Options创建可查询的加密选项

   Create the Queryable Encryption options using the generated local key string:使用生成的本地键字符串创建可查询加密选项：

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

4. Create Your Encrypted Client创建加密客户端

   Use the Mongo() constructor with the queryable encryption options configured to create a database connection. Replace the mongodb://myMongo.example.net URI with the connection string URI of the target cluster.

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

Encrypt Your Data加密数据

Retrieve the ClientEncryption object and use the ClientEncryption.encrypt() method to encrypt a value using a specific data encryption key UUID and encryption algorithm:

const eDB = "encrypted"
const eKV = "__keyVault"

const clientEncryption = encryptedClient.getClientEncryption();
const keyVaultClient = Mongo().getDB(eDB).getCollection(eKV)

const dek = keyVaultClient.findOne({ keyAltNames: "dataKey1" })

clientEncryption.encrypt(
  dek._id,
  "123-45-6789",
  "Unindexed"
)

You can also specify the algorithm using a document containing the fields:您还可以使用包含以下字段的文档指定算法：

• algorithm
• queryType
• contentionFactor

const eDB = "encrypted"
const eKV = "__keyVault"

const clientEncryption = encryptedClient.getClientEncryption();
const keyVaultClient = Mongo().getDB(eDB).getCollection(eKV)

const dek = keyVaultClient.findOne({ keyAltNames: "dataKey1" })

clientEncryption.encrypt(
  dek._id,
  "123-45-6789",
  {
    algorithm: "Indexed",
    queryType: "equality",
    contentionFactor: 8
  }
)