すべてのプロダクト
Search

このプロダクト

    Key Management Service:unWrapKey

    ドキュメントセンター

    Key Management Service:unWrapKey

    最終更新日:Dec 18, 2024

    このトピックでは、unWrapKeyコマンドを使用して暗号化キーをHSMにインポートする方法について説明します。

    機能の説明

    • unWrapKeyコマンドは、wrapKeyコマンドによってエクスポートされた暗号化鍵を利用して、暗号化された対称鍵または秘密鍵をファイルからHSMにインポートすることを可能にする。

    • 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

    Parameters

    パラメーター名

    説明

    必須 / 任意

    有効値

    -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

    キーを現在のセッションキーとして指定します。

    非対象

    特別な要件なし

    -証明

    ファームウェアレスポンスの整合性チェックを行います。

    非対象

    特別な要件なし

    -min_srv

    • 指定された時間内にキーに必要な同期サーバーの最小数を決定します (タイムアウトを参照) 。

    • キーが指定された時間内に指定された数のサーバーに同期できない場合、キーは作成されません。

    非対象

    特別な要件なし

    -タイムアウト

    • キーが指定された数のサーバーに同期する時間 (秒) を設定します (min_srvを参照) 。

    • このパラメーターは、min_srvパラメーターと組み合わせて使用する場合にのみ関連します。

    • デフォルト: タイムアウトなし。 コマンドは、キーが必要最小限のサーバーに同期するまで無期限に待機します。

    非対象

    特別な要件なし

    -t

    ハッシュアルゴリズム値を指定します。

    • 2: SHA1

    • 3: SHA-256

    • 4: SHA-384

    • 5:SHA-512

    • 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) を決定します。

    説明

    -noheaderパラメーターと、CLOUDHSM_AES_KEY_WRAPおよびNIST_AES_WRAPメカニズムで使用する場合にのみ適用できます。

    非対象

    特別な要件なし