기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CloudHSM CLI를 사용하여 비대칭 키 생성
<a name="cloudhsm-cli-generate-asymmetric-keys"></a>

에 나열된 명령을 사용하여 AWS CloudHSM 클러스터**[CloudHSM CLI에서 generate-asymmetric-pair 범주](cloudhsm_cli-key-generate-asymmetric-pair.md)**에 대한 비대칭 키 페어를 생성합니다.

## RSA 키 생성하기
<a name="cloudhsm-cli-generate-asymmetric-rsa"></a>

**key generate-asymmetric-pair rsa** 명령을 사용하여 RSA 키 페어를 생성합니다. 사용 가능한 옵션을 모두 확인하려면 **help key generate-asymmetric-pair rsa** 명령을 사용합니다.

**Example**  
다음은 RSA 2048비트 키 페어를 생성하는 예제입니다.  

```
aws-cloudhsm > key generate-asymmetric-pair rsa \
    --public-exponent 65537 \
    --modulus-size-bits 2048 \
    --public-label rsa-public-example \
    --private-label rsa-private-example
```

### 인수
<a name="cloudhsm-cli-generate-asymmetric-rsa-args"></a>

***<PUBLIC\$1LABEL>***  
퍼블릭 키에 대한 사용자 정의 레이블을 지정합니다.  
필수 항목 여부: 예

***<PRIVATE\$1LABEL>***  
프라이빗 키에 대한 사용자 정의 레이블을 지정합니다.  
필수 항목 여부: 예

***<MODULUS\$1SIZE\$1BITS>***  
모듈러스 길이를 비트 단위로 지정합니다. 최소값은 2048입니다.  
필수 항목 여부: 예

***<PUBLIC\$1EXPONENT>***  
퍼블릭 지수를 지정합니다. 값은 65537 이상의 홀수여야 합니다.  
필수 항목 여부: 예

***<PUBLIC\$1KEY\$1ATTRIBUTES>***  
`KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE`의 형식(예: `sign=true`)으로 생성된 RSA 퍼블릭 키에 대해 설정할 키 속성의 공백으로 구분된 목록을 지정합니다.  
지원되는 AWS CloudHSM 키 속성 목록은 섹션을 참조하세요[CloudHSM CLI의 키 속성](cloudhsm_cli-key-attributes.md).  
필수 여부: 아니요

***<SESSION>***  
현재 세션에만 존재하는 키를 생성합니다. 세션이 종료된 후에는 키를 복구할 수 없습니다. 다른 키를 암호화한 후 다시 재빨리 암호를 해독하는 래핑 키와 같이 키가 일시적으로 필요한 경우 이 파라미터를 사용합니다. 세션 종료 후에 암호를 해독해야 할 수 있는 데이터를 암호화하는 데 세션 키를 사용해서는 안 됩니다.  
세션 키를 영구(토큰) 키로 변경하려면 [set-attribute 키](cloudhsm_cli-key-set-attribute.md)를 사용합니다.  
기본적으로 키는 생성될 때 지속/토큰 키입니다. <SESSION>을 사용하여 이를 변경하고 이 인수로 생성된 키가 세션/임시 키인지 확인합니다.  
필수 여부: 아니요

### EC(타원 곡선 암호) 키 쌍 생성하기
<a name="cloudhsm-cli-generate-asymmetric-ec"></a>

**key generate-asymmetric-pair ec** 명령을 사용하여 EC 키 쌍을 생성합니다. 지원되는 타원 곡선의 목록을 포함하여 사용 가능한 옵션을 모두 확인하려면 **help key generate-asymmetric-pair ec** 명령을 사용합니다.

**Example**  
다음 예시에서는 SecP384R1 타원 곡선을 사용하여 EC 키 쌍을 생성합니다.  

```
aws-cloudhsm > key generate-asymmetric-pair ec \
    --curve secp384r1 \
    --public-label ec-public-example \
    --private-label ec-private-example
```

#### 인수
<a name="cloudhsm-cli-generate-asymmetric-ec-args"></a>

***<PUBLIC\$1LABEL>***  
퍼블릭 키에 대한 사용자 정의 레이블을 지정합니다. 클라이언트 SDK 5.11 이상에서 `label`에 허용되는 최대 크기는 127자입니다. 클라이언트 SDK 5.10 이하에는 126자 제한이 있습니다.  
필수 항목 여부: 예

***<PRIVATE\$1LABEL>***  
프라이빗 키에 대한 사용자 정의 레이블을 지정합니다. 클라이언트 SDK 5.11 이상에서 `label`에 허용되는 최대 크기는 127자입니다. 클라이언트 SDK 5.10 이하에는 126자 제한이 있습니다.  
필수 항목 여부: 예

***<CURVE>***  
타원 곡선의 식별자를 지정합니다.  

유효한 값:
+ prime256v1
+ secp256r1
+ secp224r1
+ secp384r1
+ secp256k1
+ secp521r1
+ ed25519(비 FIPS 모드의 hsm2m.medium 인스턴스에서만 지원됨)
필수 항목 여부: 예

***<PUBLIC\$1KEY\$1ATTRIBUTES>***  
`KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE`의 형식(예: `verify=true`)으로 생성된 EC 퍼블릭 키에 대해 설정할 키 속성의 공백으로 구분된 목록을 지정합니다.  
지원되는 AWS CloudHSM 키 속성 목록은 섹션을 참조하세요[CloudHSM CLI의 키 속성](cloudhsm_cli-key-attributes.md).  
필수 여부: 아니요

***<PRIVATE\$1KEY\$1ATTRIBUTES>***  
`KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE`의 형식(예: `sign=true`)으로 생성된 EC 프라이빗 키에 대해 설정할 키 속성의 공백으로 구분된 목록을 지정합니다.  
지원되는 AWS CloudHSM 키 속성 목록은 섹션을 참조하세요[CloudHSM CLI의 키 속성](cloudhsm_cli-key-attributes.md).  
필수 여부: 아니요

***<SESSION>***  
현재 세션에만 존재하는 키를 생성합니다. 세션이 종료된 후에는 키를 복구할 수 없습니다. 다른 키를 암호화한 후 다시 재빨리 암호를 해독하는 래핑 키와 같이 키가 일시적으로 필요한 경우 이 파라미터를 사용합니다. 세션 종료 후에 암호를 해독해야 할 수 있는 데이터를 암호화하는 데 세션 키를 사용해서는 안 됩니다.  
세션 키를 영구(토큰) 키로 변경하려면 [set-attribute 키](cloudhsm_cli-key-set-attribute.md)를 사용합니다.  
기본적으로 생성되는 키는 영구(토큰) 키입니다. <SESSION>을 전달하면 이를 변경하여 이 인수로 생성된 키가 세션(임시) 키인지 확인합니다.  
필수 여부: 아니요