ClientEncryption.decryption.decryption()
ClientEncryption.decrypt(encryptedValue)
ClientEncryption.decrypt()
encryptionValue
現在のデータベース接続がKMS (KMS )とキーヴォールトへのアクセスで構成されているencryptionValue
場合 、 は を復号化します。次の値を返します。 復号化された値。
構文
ClientEncryption.decrypt
の構文は次のとおりです。
clientEncryption = db.getMongo().getClientEncryption() clientEncryption.decrypt(encryptedValue)
は、encryptedValue
サブタイプ6binary data
を持つ オブジェクトである 必要 があります クライアント側のフィールドレベル暗号化を使用して作成された
動作
正しいconfigured
KMS(KMS )と Key Vault へのアクセスを持つデータベース接続 から発行された読み取り操作は、ClientEncryption.encrypt()
を使用して暗号化されたフィールド値を自動的に復号化できます。decrypt()
Binary
ドキュメント6 フィールド内に保存されていない サブタイプ 値を復号化するには、クライアントは を使用するだけで済みます。
データベース接続でのクライアント側のフィールドレベル暗号化の有効化
mongosh
クライアント側のフィールド レベル暗号化メソッドでは、クライアント側のフィールド レベル暗号化が有効になっているデータベース接続が必要です。現在のデータベース接続がクライアント側のフィールド レベル暗号化を有効にして開始されなかった場合、次のいずれかが発生します。
Mongo()
必要なクライアント側のフィールドレベル暗号化オプションとの接続を確立するには、mongosh
から コンストラクターを使用します。Mongo()
メソッドは、CMK(Customer Master Key)管理のために次のKMS ( KMS )プロバイダーをサポートしています。or
必要なオプションとの接続を確立するには、
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_KEY
string を使用します。var autoEncryptionOpts = { "keyVaultNamespace" : "encryption.__dataKeys", "kmsProviders" : { "local" : { "key" : BinData(0, TEST_LOCAL_KEY) } } } 暗号化されたクライアント オブジェクトの作成
暗号化されたクライアントオブジェクトを作成するには、
Mongo()
コンストラクターを使用します。mongodb://myMongo.example.net
URI を、ターゲットクラスターの接続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()
を参照してください。