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

# AWS CloudHSM KMU를 사용하여 HSM 로그인 및 로그아웃
<a name="key_mgmt_util-loginHSM"></a>

 AWS CloudHSM key\$1mgmt\$1util에서 **loginHSM** 및 **logoutHSM** 명령을 사용하여 클러스터의 하드웨어 보안 모듈(HSM)에 로그인하고 로그아웃합니다. HSM에 로그인하면 key\$1mgmt\$1util을 사용하여 퍼블릭 및 프라이빗 키 생성, 동기화, 래핑을 포함한 다양한 키 관리 작업을 수행할 수 있습니다.

key\$1mgmt\$1util 명령을 실행하기 전에 [key\$1mgmt\$1util을 시작](key_mgmt_util-setup.md#key_mgmt_util-start)해야 합니다. key\$1mgmt\$1util로 키를 관리하려면 HSM에 [CU(crypto user)](understanding-users-cmu.md#crypto-user-cmu)로 로그인해야 합니다.

**참고**  
잘못된 로그인 시도 횟수가 5회를 초과하면 계정이 잠깁니다. 2018년 2월 이전에 클러스터를 만든 경우 로그인 시도가 20회 실패한 후에 계정이 잠깁니다. 계정 잠금을 해제하려면 CO(암호화 관리자)가 cloudhsm\$1mgmt\$1util의 [changePswd](cloudhsm_mgmt_util-changePswd.md) 명령을 사용하여 암호를 재설정해야 합니다.  
클러스터에 HSM이 둘 이상인 경우 계정이 잠기기 전에 잘못된 로그인 시도가 추가로 허용될 수 있습니다. 이는 CloudHSM 클라이언트가 다양한 HSM 간에 로드 균형을 조정하기 때문입니다. 따라서 매번 동일한 HSM에서 로그인 시도가 시작되지 않을 수 있습니다. 이 기능을 테스트하는 경우 활성화된 HSM이 하나 뿐인 클러스터에서 수행하는 것이 좋습니다.

## 구문
<a name="loginHSM-syntax"></a>

```
loginHSM -h

loginHSM -u <user type>
         { -p | -hpswd } <password>
         -s <username>
```

## 예제
<a name="loginHSM-examples"></a>

이 예제에서는 `loginHSM` 및 `logoutHSM` 명령을 사용하여 클러스터의 HSM에 로그인 및 로그아웃하는 방법을 보여 줍니다.

**Example : HSM에 로그인**  
이 명령은 사용자 이름 `example_user`와 암호 `aws`를 사용하여 `CU`(crypto user)로 HSM에 로그인합니다. 출력은 클러스터의 모든 HSM에 로그인했음을 보여줍니다.  

```
Command:  loginHSM -u CU -s example_user -p aws

Cfm3LoginHSM returned: 0x00 : HSM Return: SUCCESS
    
Cluster Status
Node id 0 and err state 0x00000000 : HSM Return: SUCCESS
Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
Node id 2 and err state 0x00000000 : HSM Return: SUCCESS
```

**Example : 숨겨진 암호로 로그인**  
이 명령은 시스템이 암호를 숨기도록 지정한다는 점을 제외하면 위의 예와 동일합니다.  

```
Command:  loginHSM -u CU -s example_user -hpswd
```
시스템이 암호를 묻는 메시지를 표시합니다. 암호를 입력하면 시스템은 암호를 숨기며 출력에는 명령이 성공했고 HSM에 연결되었다는 메시지가 표시됩니다.  

```
Enter password: 

Cfm3LoginHSM returned: 0x00 : HSM Return: SUCCESS
    
Cluster Status
Node id 0 and err state 0x00000000 : HSM Return: SUCCESS
Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
Node id 2 and err state 0x00000000 : HSM Return: SUCCESS

Command:
```

**Example : HSM에서 로그아웃**  
이 명령은 HSM에서 로그아웃합니다. 출력은 클러스터의 모든 HSM에서 로그아웃했음을 보여줍니다.  

```
Command: logoutHSM

Cfm3LogoutHSM returned: 0x00 : HSM Return: SUCCESS
    
Cluster Status
Node id 0 and err state 0x00000000 : HSM Return: SUCCESS
Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
Node id 2 and err state 0x00000000 : HSM Return: SUCCESS
```

## 파라미터
<a name="loginHSM-parameters"></a>

**-h**  
이 명령에 대한 도움말을 표시합니다.

**-u**  
로그인 사용자 유형을 지정합니다. key\$1mgmt\$1util을 사용하려면 CU로 로그인해야 합니다.  
필수 항목 여부: 예

**-s**  
로그인 사용자 이름을 지정합니다.  
필수 항목 여부: 예

**\$1 -p \$1 -hpswd \$1**  
`-p`로 로그인 암호를 지정합니다. 암호를 입력하면 일반 텍스트로 암호가 나타납니다. 암호를 숨기려면 `-p` 대신 선택적 `-hpswd` 파라미터를 사용하고 프롬프트를 따릅니다.  
필수: 예

## 관련 주제
<a name="loginHSM-seealso"></a>
+ [exit](key_mgmt_util-exit.md)