Key Management Service:imSymKey

機能の説明

• imSymKeyコマンドを使用すると、プレーンテキストで保存されているキーファイルをHSMにインポートできます。暗号化されたキーファイルについては、unWrapKeyをご参照ください。

• exSymKeyとimSymKeyを使用すると、対称キーのバックアップまたは移行を容易にできます。

• 対称キーをインポートするには、imSymKeyコマンドを使用します。 公開鍵をインポートするには、「importPubKey」をご参照ください。秘密鍵については、「importPrivateKey」をご参照ください。

• HSMは、平文でのキーの直接インポートを禁止します。 最初に、imSymKeyはAESでインポートファイルを暗号化し、続いてunWrapKeyを呼び出して暗号化ファイルのHSMへのインポートを容易にします。

構文

以下の構文に従ってパラメーターを入力します。 パラメーターの詳細については、「パラメーター」をご参照ください。

imSymKey -f <key-file>
         -w <wrapping-key-handle>  
         -t <key-type>
         -l <label>
         [-id <key-ID>]
         [-sess]
         [-wk <wrapping-key-file> ]
         [-attest]
         [-min_srv <minimum-number-of-servers>]
         [-timeout <number-of-seconds> ]
         [-u <user-ids>]

例

• OpenSSLを使用してランダムな256ビットAES対称キーを生成し、aes256.keyファイルに保存します。

  openssl rand -out aes256.key 32

• imSymKeyコマンドは、AESキーをaes256.keyファイルからHSMにインポートします。

• Command:  imSymKey -f aes256.key -w 6 -t 31 -l importedaes
  
         	Cfm3ImportWrapKey returned: 0x00 : HSM Return: SUCCESS
  
         	Cfm3CreateUnwrapTemplate2 returned: 0x00 : HSM Return: SUCCESS
  
         	Cfm3ImportUnWrapKey returned: 0x00 : HSM Return: SUCCESS
  
         	Symmetric Key Imported.  Key Handle: 19
  
         	Cluster Status:
         	Node id 0 status: 0x00000000 : HSM Return: SUCCESS

Parameters