全部产品
Search
文档中心

密钥管理服务:exSymKey

更新时间:Nov 04, 2024

本文介绍如何使用exSymKey命令导出HSM上的对称密钥。

功能说明

  • exSymKey命令可将HSM的对称密钥以明文的形式导出到磁盘文件上。如需要导出加密后的对称密钥,请使用wrapKey

  • 只有密钥的所有者 (即创建该密钥的CU用户) 才能导出它。共享密钥的用户可以在加密操作中使用密钥,但无法导出它。

  • 可借助exSymKey和imSymKey完成对称密钥的备份或迁移

  • HSM不允许以明文形式直接导入密钥,exSymKey先使用wrapKey导出加密密钥文件,再调用AES解密。

重要

在运行此命令之前,必须启动key_mgmt_tool并以CU身份登录HSM。

语法

请按照下方语法输入参数,参数说明请参见参数

exSymKey -k <key-to-export>
         -w <wrapping-key>
         -out <key-file>
         [-m 4] 
         [-wk <unwrapping-key-file> ]
 
重要

您必须按语法指定的顺序输入参数。

示例

Command:  exSymKey -k 9 -w 6 -out /tmp/aes.key

       	Cfm3ExportWrapKeyWithMech returned: 0x00 : HSM Return: SUCCESS

       	Cfm3ExportUnwrapKeyWithMech returned: 0x00 : HSM Return: SUCCESS


Exported Symmetric Key written to file "/tmp/aes.key"

参数

参数名称

描述

是否必需

有效值

-k

指定导出密钥的句柄。

您可使用findKey查找密钥的密钥句柄

-w

指定加密导出密钥的密钥句柄。

您可使用findKey查找密钥的密钥句柄

-out

指定存储导出密钥的文件名称。

无特殊要求

-m

指定加密导出密钥的加密机制

4(NIST_AES_WRAP)

-wk

指定解密导出密钥的文件,包含AES密钥的文件的路径和名称。

默认为-w指定的加密密钥