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

# AWS CloudHSM 클라이언트 SDK 5용 키 스토리지 공급자(KSP)에 인증
<a name="ksp-library-authentication"></a>

 AWS CloudHSM 클라이언트 SDK 5용 키 스토리지 공급자(KSP)를 사용하기 전에 시스템의 HSM에 대한 로그인 자격 증명을 설정해야 합니다. 여기에는 두 가지 옵션이 있습니다.
+ Windows Credentials Manager(보안 강화를 위해 권장)
+ 시스템 환경 변수(단순한 설정)

## Windows 자격 증명 관리자
<a name="sdk5-wcm"></a>

`set_cloudhsm_credentials` 유틸리티 또는 Windows Credentials Manager 인터페이스를 사용하여 자격 증명을 설정할 수 있습니다.
+ **`set_cloudhsm_credentials` 유틸리티 사용**:

  Windows 설치 프로그램에는 `set_cloudhsm_credentials` 유틸리티가 포함되어 있습니다. 이 유틸리티를 사용하여 HSM 로그인 자격 증명을 Windows 자격 증명 관리자에 편리하게 전달할 수 있습니다. 소스에서 이 유틸리티를 컴파일하려는 경우 설치 프로그램에 포함된 Python 코드를 사용할 수 있습니다.

  1. `C:\Program Files\Amazon\CloudHSM\tools\`로 이동합니다.

  1. 다음 명령을 실행합니다.

     ```
     set_cloudhsm_credentials.exe --username <CU USER> --password <CU PASSWORD>
     ```
+ **자격 증명 관리자 인터페이스 사용**:

  1. Credential Manager를 엽니다.
     + 작업 표시줄 검색 상자에 `credential manager`를 입력합니다.
     + **자격 증명 관리자** 선택

  1. **Windows 자격 증명**을 선택하여 Windows 자격 증명을 관리합니다.

  1. **일반 자격 증명 추가**를 선택합니다.

  1. 다음 세부 정보를 입력합니다.
     + **인터넷 또는 네트워크 주소**: `CLOUDHSM_PIN`.
     + **사용자 이름**: *<CU USER>*.
     + **암호**: *<CU PASSWORD>*.

  1. **확인**을 선택합니다.

## 시스템 환경 변수
<a name="sdk5-enviorn-var"></a>

HSM 및 [Crypto User](understanding-users.md#crypto-user-chsm-cli)(CU)를 식별하는 시스템 환경 변수를 설정할 수 있습니다.

**주의**  
시스템 환경 변수를 통해 자격 증명을 설정하면 암호가 시스템에 일반 텍스트로 저장됩니다. 보안 강화를 위해 Windows Credential Manager를 대신 사용합니다.

다음을 사용하여 환경 변수를 설정할 수 있습니다.
+ [https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx).
+ Windows **시스템 속성** 제어판(**고급** 탭).
+ 영구 시스템 환경 변수 [Programmatic](https://msdn.microsoft.com/en-us/library/system.environment.setenvironmentvariable(v=vs.110).aspx) 방식을 설정합니다.

시스템 환경 변수를 설정하려면:

**`CLOUDHSM_PIN=<CU USERNAME>:<CU PASSWORD>`**  
HSM의 [CU(Crypto User)](understanding-users.md#crypto-user-chsm-cli)를 식별하고 필요한 모든 로그인 정보를 제공합니다. 애플리케이션에서는 해당 CU로 인증하고 실행합니다. 애플리케이션은 이 CU의 권한을 가지며 CU가 소유하고 공유하는 키만 보고 관리할 수 있습니다. 새 CU를 생성하려면 CloudHSM CLI에서 [사용자 생성](cloudhsm_cli-user-create.md) 명령을 사용합니다. 기존 CU를 찾으려면 CloudHSM CLI에서 [사용자 목록](cloudhsm_cli-user-list.md) 명령을 사용합니다.  
예제:  

```
setx /m CLOUDHSM_PIN test_user:password123
```

**참고**  
CLOUDHSM\$1PIN 환경 변수를 설정할 때는 쉘에서 해석할 수 있는 특수 문자를 이스케이프 처리해야 합니다.