ClientEncryption.decrypt(encryptedValue)ClientEncryption.decrypt()encryptionValue現在のデータベース接続が の暗号化に使用されている KMS(Key Management Service)とキーヴォールトへのアクセスで構成されている場合、encryptionValueは を復号化します。次の値を返します。 復号化された値。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
- MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
ClientEncryption.decrypt の構文は次のとおりです。
clientEncryption = db.getMongo().getClientEncryption() clientEncryption.decrypt(encryptedValue)
は、encryptedValue クライアント側のフィールドレベル暗号化を使用して作成されたサブタイプbinary data 6を持つ オブジェクトである必要があります。
動作
正しい KMS(Key Management Service)と Key Vault にアクセスするデータベース接続 configured から発行された読み取り操作は、ClientEncryption.encrypt() を使用して暗号化されたフィールド値を自動的に復号化できます。ドキュメントフィールド内に保存されていない Binary サブタイプ 6 値を復号化するには、クライアントは decrypt() を使用するだけで済みます。
データベース接続でのクライアント側のフィールドレベル暗号化の有効化
mongoshClientEncryptionメソッドでは、使用中の暗号化が有効になっているデータベース接続が必要です。現在のデータベース接続が使用中の暗号化を有効にして開始されなかった場合、次のいずれかが発生します。
mongosh必要なオプションとの接続を確立するには、 コマンドラインオプションを使用します。コマンドラインオプションは、CMK 管理用のAmazon Web Services KMS プロバイダーのみをサポートしています。
例
次の例では、クライアント側のフィールドレベル暗号化構成にローカルで管理されている KMS を使用しています。
暗号化された接続の作成
mongosh を起動する
実行:
mongosh --nodb --nodbは、データベースに接続しないことを意味します。キーstringの生成
基本64 96バイトの string を生成する:
const TEST_LOCAL_KEY = require("crypto").randomBytes(96).toString("base64") 暗号化オプション オブジェクトの作成
クライアント側のフィールドレベル暗号化オプションオブジェクトを作成するには、前のステップの
TEST_LOCAL_KEYstring を使用します。var autoEncryptionOpts = { "keyVaultNamespace" : "encryption.__dataKeys", "kmsProviders" : { "local" : { "key" : BinData(0, TEST_LOCAL_KEY) } } } 暗号化されたクライアント オブジェクトの作成
暗号化されたクライアントオブジェクトを作成するには、
Mongo()コンストラクターを使用します。mongodb://myMongo.example.netURI を、ターゲットクラスターの接続string URIに置き換えます。 (例: )。encryptedClient = Mongo( "mongodb://myMongo.example.net:27017/?replSetName=myMongo", autoEncryptionOpts )
データの復号化
ClientEncryptionオブジェクトを取得し、 メソッドを使用してClientEncryption.decrypt() ClientEncryption.encrypt()によって暗号化された値を復号化します。
clientEncryption = encryptedClient.getClientEncryption(); clientEncryption.decrypt(BinData(6,"AmTi2H3xaEk8u9+jlFNaLLkC3Q/+kmwDbbWrq+h9nuv9W+u7A5a0UnpULBNZH+Q21fAztPpU09wpKPrju9dKfpN1Afpj1/ZhFcH6LYZOWSBBOAuUNjPLxMNSYOOuITuuYWo="))
結果の例
成功した場合、decrypt() は復号化された値を返します。
"123-45-6789"
詳細
クライアント側のフィールドレベル暗号化を有効にして MongoDB 接続を開始する方法に関する詳細なドキュメントについては、 Mongo()を参照してください。