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

# AWS CloudHSM Windows 클라이언트를 사용하기 위한 사전 조건
<a name="ksp-library-prereq"></a>

Windows AWS CloudHSM 클라이언트를 시작하고 KSP 및 CNG 공급자를 사용하려면 먼저 시스템의 HSM에 대한 로그인 자격 증명을 설정해야 합니다. Windows 자격 증명 관리자 또는 시스템 환경 변수를 통해 자격 증명을 설정할 수 있습니다. 자격 증명 저장에는 Windows 자격 증명 관리자를 사용하는 것이 좋습니다. 이 옵션은 AWS CloudHSM 클라이언트 버전 2.0.4 이상에서 사용할 수 있습니다. 환경 변수를 사용하면 더 쉽게 설정할 수 있지만 Windows 자격 증명 관리자를 사용할 때보다 안전하지 않습니다.

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

`set_cloudhsm_credentials` 유틸리티 또는 Windows 자격 증명 관리자 인터페이스를 사용할 수 있습니다.
+ **`set_cloudhsm_credentials` 유틸리티 사용**:

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

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

  1. CU 사용자 이름 및 암호 파라미터를 사용하여 `set_cloudhsm_credentials.exe` 파일을 실행합니다.

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

  자격 증명 관리자 인터페이스를 사용하여 자격 증명을 수동으로 관리할 수 있습니다.

  1. 자격 증명 관리자를 열려면 작업 표시줄의 검색 상자에 `credential manager`를 입력하고 **자격 증명 관리자**를 선택합니다.

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

  1. **일반 자격 증명 추가**를 선택하고 다음과 같이 세부 정보를 채웁니다.
     + **인터넷 또는 네트워크 주소**에 대상 이름을 `cloudhsm_client`로 입력합니다.
     + **사용자 이름** 및 **암호**에 CU 자격 증명을 입력합니다.
     + **확인**을 클릭합니다.

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

Windows 애플리케이션용 HSM 및 [CU(Crypto User)](understanding-users-cmu.md#crypto-user-cmu)를 식별하는 시스템 환경 변수를 설정할 수 있습니다. [**setx**명령](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx)을 사용하여 시스템 환경 변수를 설정하거나, [프로그래밍 방식](https://msdn.microsoft.com/en-us/library/system.environment.setenvironmentvariable(v=vs.110).aspx)으로 또는 Windows **시스템 속성** 제어판의 **고급** 탭에서 영구 시스템 환경 변수를 설정할 수 있습니다.

**주의**  
시스템 환경 변수를 통해 자격 증명을 설정하면 사용자의 시스템에서 일반 텍스트로 암호를 사용할 수 있습니다. 이 문제를 해결하려면 Windows 자격 증명 관리자를 사용하십시오.

다음 시스템 환경 변수를 설정합니다.

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

```
setx /m n3fips_password test_user:password123
```