KeyVault.removeKeyAlternateName()

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 客户端字段级加密方法 > KeyVault.removeKeyAlternateName()

在本页面

行为
例

KeyVault.removeKeyAlternateName（UUID，keyAltName ）¶

从指定keyAltName的数据加密密钥中删除指定的UUID。数据加密密钥必须存在于与数据库连接关联的密钥库中。

removeKeyAlternateName() 具有以下语法：

keyVault = db.getMongo().getKeyVault()

keyVault.removeKeyAlternateName(
  UUID("<UUID string>"),
  "keyAltName"
)

返回：	更新之前的数据加密密钥`keyAltName`。 `null`如果没有指定的数据加密密钥，则返回`UUID()`。

行为¶

需要在数据库连接上配置客户端字段级加密¶

该mongo客户端的字段级的加密方法需要与客户端的字段级加密的数据库连接启用。如果当前数据库连接不是在启用客户端字段级加密的情况下启动的，则可以：

使用外壳程序中的Mongo()构造函数mongo与所需的客户端字段级加密选项建立连接。该Mongo()方法同时支持Amazon Web Services和本地密钥管理服务（KMS）提供程序，用于客户主密钥（CMK）管理。

要么
使用mongoshell 命令行选项与所需选项建立连接。命令行选项仅支持AWS KMS提供程序进行CMK管理。

例子¶

以下示例旨在快速评估客户端字段级加密。有关适用于开发和生产环境的更完整的示例，请参阅管理数据加密密钥的备用名称。

为本地管理的密钥配置客户端字段级加密需要指定没有换行符的base64编码的96字节字符串。以下操作将生成满足所述要求的密钥并将其加载到mongo外壳中：

复制

TEST_LOCAL_KEY=$(echo "$(head -c 96 /dev/urandom | base64 | tr -d '\n')")

mongo --nodb --shell --eval "var TEST_LOCAL_KEY='$TEST_LOCAL_KEY'"

使用生成的本地密钥字符串创建客户端字段级加密对象：

复制

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

使用Mongo()构造函数使用客户端字段级加密选项创建数据库连接。用目标集群mongodb://myMongo.example.net的连接字符串URI替换 URI 。

复制

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

检索keyVault对象并使用该 KeyVault.removeKeyAlternateName()方法从具有以下匹配条件的数据加密密钥中删除指定的密钥备用名称 UUID：

复制

keyVault = encryptedClient.getKeyVault()
keyVault.removeKeyAlternateName(UUID("b4b41b33-5c97-412e-a02b-743498346079"),"Other-Data-Encryption-Key")

如果成功，removeKeyAlternateName()则在更新之前返回数据加密密钥keyAltName。

复制

{
    "_id" : UUID("b4b41b33-5c97-412e-a02b-743498346079"),
    "keyMaterial" : BinData(0,"PXRsLOAYxhzTS/mFQAI8486da7BwZgqA91UI7NKz/T/AjB0uJZxTvhvmQQsKbCJYsWVS/cp5Rqy/FUX2zZwxJOJmI3rosPhzV0OI5y1cuXhAlLWlj03CnTcOSRzE/YIrsCjMB0/NyiZ7MRWUYzLAEQnE30d947XCiiHIb8a0kt2SD0so8vZvSuP2n0Vtz4NYqnzF0CkhZSWFa2e2yA=="),
    "creationDate" : ISODate("2019-08-12T21:21:30.569Z"),
    "updateDate" : ISODate("2019-08-12T21:21:30.569Z"),
    "status" : 0,
    "version" : NumberLong(0),
    "masterKey" : {
        "provider" : "local"
    },
    "keyAltNames" : [
        "ssn-encryption-key"
    ]
}