AWS CloudHSM 클라이언트 SDK 3 구성 예제 - AWS CloudHSM

AWS CloudHSM 클라이언트 SDK 3 구성 예제

다음 예제에서는 AWS CloudHSM 클라이언트 SDK 3용 configure 도구를 사용하는 방법을 보여 줍니다.

예 : AWS CloudHSM 클라이언트 및 key_mgmt_util용 HSM 데이터 업데이트

이 예제에서는 configure-a 파라미터를 사용하여 AWS CloudHSM 클라이언트 및 key_mgmt_util용 HSM 데이터를 업데이트합니다. -a 파라미터를 사용하려면 클러스터에 있는 HSM 중 하나의 IP 주소가 있어야 합니다. 콘솔 또는 AWS CLI를 사용하여 IP 주소를 가져오세요.

HSM의 IP 주소를 가져오려면(콘솔)
  1. https://console.aws.amazon.com/cloudhsm/home에서 AWS CloudHSM 콘솔을 엽니다.

  2. AWS 리전을 변경하려면 페이지의 오른쪽 상단에 있는 리전 선택기를 사용합니다.

  3. 클러스터 세부 정보 페이지를 열려면 클러스터 테이블에서 클러스터 ID를 선택합니다.

  4. IP 주소를 가져오려면 HSM 탭에서 ENI IP 주소 아래에 나열된 IP 주소 중 하나를 선택합니다.

HSM의 IP 주소를 가져오려면(AWS CLI)
  • AWS CLI의 describe-clusters 명령을 사용하여 HSM의 IP 주소를 가져옵니다. 명령의 출력에서 HSM의 IP 주소는 EniIp의 값입니다.

    $ aws cloudhsmv2 describe-clusters { "Clusters": [ { ... } "Hsms": [ { ... "EniIp": "10.0.0.9", ... }, { ... "EniIp": "10.0.1.6", ...
HSM 데이터를 업데이트하려면
  1. -a 파라미터를 업데이트하기 전에 AWS CloudHSM 클라이언트를 중지합니다. 이렇게 하면 configure가 클라이언트의 구성 파일을 편집하는 동안 발생할 수 있는 충돌이 방지됩니다. 클라이언트가 이미 중지된 경우, 이 명령은 아무런 악영향이 없으므로 스크립트에서 사용할 수 있습니다.

    Amazon Linux
    $ sudo stop cloudhsm-client
    Amazon Linux 2
    $ sudo service cloudhsm-client stop
    CentOS 7
    $ sudo service cloudhsm-client stop
    CentOS 8
    $ sudo service cloudhsm-client stop
    RHEL 7
    $ sudo service cloudhsm-client stop
    RHEL 8
    $ sudo service cloudhsm-client stop
    Ubuntu 16.04 LTS
    $ sudo service cloudhsm-client stop
    Ubuntu 18.04 LTS
    $ sudo service cloudhsm-client stop
    Windows
    • Windows 클라이언트 1.1.2+의 경우:

      C:\Program Files\Amazon\CloudHSM>net.exe stop AWSCloudHSMClient
    • Windows 클라이언트 1.1.1 이상의 경우:

      AWS CloudHSM 클라이언트를 시작한 명령 창에서 Ctrl + C를 사용하십시오.

  2. 이 단계에서는 configure-a 파라미터를 사용하여 10.0.0.9 ENI IP 주소를 구성 파일에 추가합니다.

    Amazon Linux
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Amazon Linux 2
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    CentOS 7
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    CentOS 8
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    RHEL 7
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    RHEL 8
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Ubuntu 16.04 LTS
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Ubuntu 18.04 LTS
    $ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe -a 10.0.0.9
  3. 이제, AWS CloudHSM 클라이언트를 다시 시작합니다. 클라이언트를 시작할 때 구성 파일의 ENI IP 주소를 사용하여 클러스터를 쿼리합니다. 그런 다음 클러스터에 있는 모든 HSM의 ENI IP 주소를 cluster.info 파일에 씁니다.

    Amazon Linux
    $ sudo start cloudhsm-client
    Amazon Linux 2
    $ sudo service cloudhsm-client start
    CentOS 7
    $ sudo service cloudhsm-client start
    CentOS 8
    $ sudo service cloudhsm-client start
    RHEL 7
    $ sudo service cloudhsm-client start
    RHEL 8
    $ sudo service cloudhsm-client start
    Ubuntu 16.04 LTS
    $ sudo service cloudhsm-client start
    Ubuntu 18.04 LTS
    $ sudo service cloudhsm-client start
    Windows
    • Windows 클라이언트 1.1.2+의 경우:

      C:\Program Files\Amazon\CloudHSM>net.exe start AWSCloudHSMClient
    • Windows 클라이언트 1.1.1 이상의 경우:

      C:\Program Files\Amazon\CloudHSM>start "cloudhsm_client" cloudhsm_client.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_client.cfg

    명령이 완료되면 AWS CloudHSM 클라이언트와 key_mgmt_util이 사용하는 HSM 데이터가 완료되고 정확해집니다.

예 : 클라이언트 SDK 3.2.1 및 이전 버전에서 CMU용 HSM 데이터 업데이트

이 예제에서는 -m configure 명령을 사용하여 업데이트된 HSM 데이터의 사본을 cluster.info 파일에서 cloudhsm_mgmt_util이 사용하는 cloudhsm_mgmt_util.cfg 파일로 복사합니다. 클라이언트 SDK 3.2.1 및 이전 버전과 함께 제공되는 CMU와 함께 사용할 수 있습니다.

  • 이전 예제와 -m을 실행하기 전에 AWS CloudHSM 클라이언트를 중지하고 -a 명령을 실행한 다음 AWS CloudHSM 클라이언트를 다시 시작합니다. 이렇게 하면 cluster.info 파일에서 cloudhsm_mgmt_util.cfg 파일로 복사되는 데이터가 완전하고 정확해집니다.

    Linux
    $ sudo /opt/cloudhsm/bin/configure -m
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe -m
예 : 클라이언트 SDK 3.3.0 이상에서 CMU용 HSM 데이터 업데이트

이 예제에서는 configure 명령의 --cmu 파라미터를 사용하여 CMU용 HSM 데이터를 업데이트합니다. 클라이언트 SDK 3.3.0 이상과 함께 제공되는 CMU와 함께 이 기능을 사용하세요. CMU 사용에 대한 자세한 내용은 CloudHSM 관리 유틸리티(CMU) 를 사용하여 사용자 관리 및 클라이언트 SDK 3.2.1 및 이전 버전과 함께 CMU 사용을 참조하세요.

  • --cmu 파라미터를 사용하여 클러스터에 있는 HSM의 IP 주소를 전달할 수 있습니다.

    Linux
    $ sudo /opt/cloudhsm/bin/configure --cmu <IP address>
    Windows
    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe --cmu <IP address>