全部產品
Search

搜尋本產品

    Key Management Service：unWrapKey

    文件中心

    Key Management Service：unWrapKey

    更新時間：Nov 14, 2024

    本文介紹如何使用unWrapKey命令向HSM匯入加密金鑰。

    功能說明

    • unWrapKey命令將已加密的對稱金鑰或私人密鑰從檔案匯入到 HSM 中，操作對象是由wrapKey命令匯出的加密金鑰。

    • 可藉助unWrapKey和wrapKey完成密鑰的備份和遷移。

    重要

    在運行此命令之前，必須啟動key_mgmt_tool並以CU身份登入HSM。

    文法

    請按照下方文法輸入參數，參數說明請參見參數。

    unWrapKey -f <key-file-name> 
          -w <wrapping-key-handle> 
          [-sess]
          [-min_srv <minimum-number-of-HSMs>]          
          [-timeout <number-of-seconds>]
          [-tag_size <tag size>]
          [-iv_file <IV file>]
          [-attest]
          [-m <wrapping-mechanism>]
          [-t <hash-type>]
          [-nex]
          [-noheader]
          [-l <key-label>]
          [-id <key-id>]
          [-kt <key-type>]
          [-kc <key-class]
          [-i <unwrapping-IV>]
    重要

    您必須按文法指定的順序輸入參數。

    樣本

    本文以匯入AES加密金鑰檔案為例，該密鑰用控制代碼為6的AES密鑰解密，輸出結果顯示匯入後密鑰的控制代碼為22。

    Command:   unWrapKey -f aes-encrypted.key -w 6 -m 4

       	Cfm2UnWrapKey5 returned: 0x00 : HSM Return: SUCCESS

       	Key Unwrapped.  Key Handle: 22

       	Cluster Status:
       	Node id 0 status: 0x00000000 : HSM Return: SUCCESS

    參數

    參數名稱

    描述

    是否必需

    有效值

    -f

    指定加密金鑰檔案的路徑和名稱。

    是

    無特殊要求

    -w

    指定解密的密鑰控制代碼。

    是

    無特殊要求

    -m

    指定解密機制。

    是

    • 4：AES_KEY_WRAP_PAD_PKCS5

    • 5：NIST_AES_WRAP_NO_PAD

    • 6：NIST_AES_WRAP_PAD

    • 7：RSA_AES

    • 8：RSA_OAEP

    • 9：NIST_TDEA_WRAP

    • 10：AES_GCM

    • 11：CLOUDHSM_AES_GCM

    tag_size

    指定資料區塊大小。

    說明

    僅當解密機製為AES_GCM和CLOUDHSM_AES_GCM時有效。

    否

    無特殊要求

    iv_file

    指定AES初始向量的長度。

    說明

    僅當解密機製為AES_GCM時有效。

    否

    無特殊要求

    -sess

    指定密鑰作為當前工作階段金鑰。

    否

    無特殊要求

    -attest

    對韌體響應進行完整性檢查。

    否

    無特殊要求

    -min_srv

    • 指定分配的時間（參見timeout）之內，密鑰最少需要的同步的伺服器數量。

    • 如果密鑰在分配的時間內未同步到指定數量的伺服器，則不會建立它。

    否

    無特殊要求

    -timeout

    • 指定密鑰同步到指定數量（參見min_srv）的伺服器所需時間（以秒為單位）。

    • 僅當min_srv參數也用於此命令時，該參數才有效。

    • 預設：沒有逾時該命令無限期等待，僅當密鑰同步至最少數量的伺服器時才返回。

    否

    無特殊要求

    -t

    指定雜湊演算法的值。

    • 2：SHA1

    • 3：SHA256

    • 4：SHA384

    • 5：SHA512

    • 6：SHA224 (（對RSA_AES和RSA_OAEP有效）)

    -nex

    將密鑰設定成不可匯出。

    否

    無特殊要求

    -noheader

    忽略特定密鑰屬性的標題。

    否

    無特殊要求

    -l

    指定匯入密鑰標籤。

    說明

    僅當和-noheader參數一起傳遞時有效。

    否

    無特殊要求

    -id

    指定匯入密鑰的ID。

    說明

    僅當和-noheader參數一起傳遞時有效。

    無特殊要求

    -kc

    指定匯入密鑰的類別。

    說明

    僅當和-noheader參數一起傳遞時有效。

    否

    • 3：私人密鑰

    • 4：對稱金鑰

    -kt

    指定匯入密鑰的類型。

    說明

    僅當和-noheader參數一起傳遞時有效。

    否

    • 0：RSA

    • 1 ：DSA

    • 3 ：ECC

    • 16 ：GENERIC_SECRET

    • 21 ：DES3

    • 31 ：AES

    -i

    指定匯入密鑰的初始化向量IV。

    說明

    僅當通過CLOUDHSM_AES_KEY_WRAP和NIST_AES_WRAP機制的-noheader參數傳遞時有效。

    否

    無特殊要求