genSymKey

이 명령은 레이블이 aes256인 256비트 AES 키를 생성합니다. 출력은 새 키의 키 핸들이 6임을 보여 줍니다.

Command: genSymKey -t 31 -s 32 -l aes256

        Cfm3GenerateSymmetricKey returned: 0x00 : HSM Return: SUCCESS

        Symmetric Key Created.  Key Handle: 6

        Cluster Error Status
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS

이 명령은 현재 세션에서만 유효한 추출할 수 없는 192비트 AES 키를 생성합니다. 키를 래핑(그런 다음 즉시 언래핑)하려면 이와 같은 키를 생성할 수 있습니다.

Command: genSymKey -t 31 -s 24 -l tmpAES -id wrap01 -nex -sess 

이 명령은 라벨이 IT_test_key인 일반 512비트 키를 생성합니다. 이 명령은 키가 클러스터의 모든 HSM과 동기화될 때까지 기다리지 않습니다. 대신, 어느 한 HSM에서 키가 생성되는 시점(-min_srv 1) 또는 1초(-timeout 1) 중 먼저 도래하는 시점에 키를 반환합니다. 키가 시간 제한이 경과할 때까지 지정된 최소 수의 HSM에 동기화되지 않으면 키가 생성되지 않습니다. 다음 예제의 for 루프와 같이, 여러 개의 키를 생성하려면 스크립트에서 이러한 명령을 사용할 수 있습니다.

Command: genSymKey -t 16 -s 512 -l IT_test_key -min_srv 1 -timeout 1

$  for i in {1..30}; 
     do /opt/cloudhsm/bin/key_mgmt_util singlecmd loginHSM -u CU -s example_user -p example_pwd genSymKey -l aes -t 31 -s 32 -min_srv 1 -timeout 1; 
 done;

이 명령은 라벨이 generic-mV2인 2,048비트 일반 보안 키를 생성합니다. 이 명령은 -u 파라미터를 사용하여 키를 다른 CU 사용자 6과 공유합니다. 이 명령은 -m_value 파라미터를 사용하여 키를 사용하는 암호화 작업에 대한 최소 2개의 승인을 쿼럼에 요청합니다. 또 -attest 파라미터를 사용하여 키가 생성되는 펌웨어의 무결성을 확인합니다.

출력은 이 명령이 키 핸들이 9인 키를 생성하고 클러스터 펌웨어에서의 증명 점검에 통과했음을 보여 줍니다.

                Command:  genSymKey -t 16 -s 2048 -l generic-mV2 -m_value 2 -u 6 -attest

        Cfm3GenerateSymmetricKey returned: 0x00 : HSM Return: SUCCESS

        Symmetric Key Created.  Key Handle: 9

        Attestation Check : [PASS]

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS
      

명령은 레이블이 3DES_shared이고 ID가 IT-02인 Triple DES 키를 생성합니다. 이 키는 현재 사용자, 사용자 4 및 사용자 5가 사용할 수 있습니다. ID가 클러스터에서 고유하지 않거나 현재 사용자가 사용자 4 또는 5일 경우 명령이 실패합니다.

출력은 새 키의 키 핸들이 7임을 보여줍니다.

Command: genSymKey -t 21 -s 24 -l 3DES_shared -id IT-02 -u 4,5

       Cfm3GenerateSymmetricKey returned: 0x00 : HSM Return: SUCCESS

        Symmetric Key Created.  Key Handle: 7

        Cluster Error Status
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS

새 3DES 키를 현재 사용자가 소유하고 사용자 4 및 5와 공유하는지 확인하려면 getKeyInfo를 사용합니다. 이 명령은 새 키에 할당된 핸들(Key Handle: 7)을 사용합니다.

출력은 이 키를 사용자 3이 소유하고 사용자 4 및 5와 공유하고 있음을 보여 줍니다.

Command:  getKeyInfo -k 7

        Cfm3GetKey returned: 0x00 : HSM Return: SUCCESS

        Owned by user 3

        also, shared to following 2 user(s):

                 4, 5

키의 다른 속성을 확인하려면 getAttribute를 사용합니다. 첫 번째 명령은 getAttribute를 사용하여 키 핸들 7(-o 7)의 모든 속성(-a 512)을 가져옵니다. 이 명령은 결과를 attr_7 파일에 기록합니다. 두 번째 명령은 cat을 사용하여 attr_7 파일의 내용을 가져옵니다.

이 명령은 키 7이 레이블이 3DES_shared(OBJ_ATTR_LABEL 3DES_shared)이고 ID가 IT_02(OBJ_ATTR_ID IT-02)인 192비트(OBJ_ATTR_VALUE_LEN 0x00000018 또는 24바이트) 3DES(OBJ_ATTR_KEY_TYPE 0x15) 대칭 키(OBJ_ATTR_CLASS 0x04)임을 확인해 줍니다. 키는 영구적이며(OBJ_ATTR_TOKEN 0x01) 추출 가능하며(OBJ_ATTR_EXTRACTABLE 0x01) 암호화, 암호 해독 및 래핑에 사용할 수 있습니다.

키 속성 해석에 대한 도움말은 키 속성 참조 섹션을 참조하십시오.

Command:  getAttribute -o 7 -a 512 -out attr_7

got all attributes of size 444 attr cnt 17
Attributes dumped into attr_7 file

        Cfm3GetAttribute returned: 0x00 : HSM Return: SUCCESS


$  cat attr_7

OBJ_ATTR_CLASS
0x04
OBJ_ATTR_KEY_TYPE
0x15
OBJ_ATTR_TOKEN
0x01
OBJ_ATTR_PRIVATE
0x01
OBJ_ATTR_ENCRYPT
0x01
OBJ_ATTR_DECRYPT
0x01
OBJ_ATTR_WRAP
0x00
OBJ_ATTR_UNWRAP
0x00
OBJ_ATTR_SIGN
0x00
OBJ_ATTR_VERIFY
0x00
OBJ_ATTR_LOCAL
0x01
OBJ_ATTR_SENSITIVE
0x01
OBJ_ATTR_EXTRACTABLE
0x01
OBJ_ATTR_LABEL
3DES_shared
OBJ_ATTR_ID
IT-02
OBJ_ATTR_VALUE_LEN
0x00000018
OBJ_ATTR_KCV
0x59a46e