CloudHSM CLI를 사용하여 여러 클러스터에 연결 - AWS CloudHSM

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

CloudHSM CLI를 사용하여 여러 클러스터에 연결

클라이언트 SDK 5를 사용하면 단일 CLI 인스턴스에서 여러 CloudHSM 클러스터에 연결할 수 있도록 CloudHSM CLI를 구성할 수 있습니다.

CloudHSM CLI를 사용하여 다중 클러스터 기능을 사용하여 여러 클러스터에 연결하려면 이 항목의 지침을 따르십시오.

다중 클러스터 사전 요구 사항

  • 연결하려는 두 개 이상의 AWS CloudHSM 클러스터와 해당 클러스터 인증서

  • 위의 모든 클러스터에 연결하도록 보안 그룹이 올바르게 구성된 EC2 인스턴스. 클러스터 및 클라이언트 인스턴스를 설정하는 방법에 대한 자세한 내용은 시작하기를 참조하십시오 AWS CloudHSM.

  • 다중 클러스터 기능을 설정하려면 CloudHSM CLI를 이미 다운로드하여 설치해야 합니다. 아직 수행하지 않은 경우 CloudHSM 명령줄 인터페이스(CLI) 시작하기의 지침을 참조하십시오.

  • 로 구성된 클러스터는 a와 연결되지 ./configure-cli[.exe] -a 않으므로 액세스할 수 없습니다. cluster-id 이 가이드에 설명된 config-cli add-cluster 대로 재구성할 수 있습니다.

다중 클러스터 기능을 위한 CloudHSM CLI를 구성합니다.

다중 클러스터 기능을 위해 CloudHSM CLI를 구성하려면 다음 단계를 따르십시오.

  1. 연결하려는 클러스터를 식별하십시오.

  2. 아래 설명과 같이 configure-cli 하위 명령을 사용하여 CloudHSM CLI 구성에 이러한 클러스터를 추가합니다. add-cluster

  3. 새 구성을 적용하려면 모든 CloudHSM CLI 프로세스를 다시 시작하십시오.

구성-cli 추가 클러스터

여러 클러스터에 연결하는 경우 configure-cli add-cluster 명령을 사용하여 구성에 클러스터를 추가합니다.

구문

configure-cli add-cluster [OPTIONS] --cluster-id <CLUSTER ID> [--region <REGION>] [--endpoint <ENDPOINT>] [--hsm-ca-cert <HSM CA CERTIFICATE FILE>] [--server-client-cert-file <CLIENT CERTIFICATE FILE>] [--server-client-key-file <CLIENT KEY FILE>] [-h, --help]

cluster-id 파라미터와 함께 configure-cli add-cluster을 사용하여 구성에 클러스터(ID cluster-1234567)를 추가합니다.

Linux
$ sudo /opt/cloudhsm/bin/configure-cli add-cluster --cluster-id cluster-1234567
Windows
C:\Program Files\Amazon\CloudHSM\> .\configure-cli.exe add-cluster --cluster-id cluster-1234567
작은 정보

cluster-id 파라미터와 함께 configure-cli add-cluster을 사용해도 클러스터가 추가되지 않는 경우, 추가되는 클러스터를 식별하기 위해 --region--endpoint 파라미터도 필요한 이 명령의 더 긴 버전에 대한 다음 예를 참조하십시오. 예를 들어 클러스터의 리전이 AWS CLI 기본값으로 구성된 리전과 다른 경우 --region 파라미터를 사용하여 올바른 리전을 사용해야 합니다. 또한 호출에 사용할 AWS CloudHSM API 엔드포인트를 지정할 수 있습니다. 이는 기본 DNS 호스트 이름을 사용하지 않는 VPC 인터페이스 엔드포인트를 사용하는 등 다양한 네트워크 설정에 필요할 수 있습니다. AWS CloudHSM

cluster-id, endpoint, region 파라미터와 함께 configure-cli add-cluster을 사용하여 구성에 클러스터(ID cluster-1234567)를 추가합니다.

Linux
$ sudo /opt/cloudhsm/bin/configure-cli add-cluster --cluster-id cluster-1234567 --region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com
Windows
C:\Program Files\Amazon\CloudHSM\> .\configure-cli.exe add-cluster --cluster-id cluster-1234567 --region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com

--cluster-id, --region, --endpoint 파라미터에 대한 자세한 내용은 파라미터 섹션을 참조하십시오.

파라미터

--cluster-id <Cluster ID>

클러스터 ID와 연결된 클러스터의 모든 HSM Elastic Network 인터페이스(ENI) IP 주소를 찾기 위해 DescribeClusters를 호출합니다. 시스템은 ENI IP 주소를 구성 파일에 추가합니다. AWS CloudHSM

참고

퍼블릭 인터넷에 액세스할 수 없는 VPC 내 EC2 인스턴스의 --cluster-id 파라미터를 사용하는 경우 연결할 인터페이스 VPC 엔드포인트를 만들어야 합니다. AWS CloudHSM VPC 엔드포인트에 대한 자세한 내용은 AWS CloudHSM 및 VPC 엔드포인트 섹션을 참조하십시오.

필수 여부: 예

--endpoint <Endpoint>

AWS CloudHSM 호출에 사용되는 API 엔드포인트를 지정합니다. DescribeClusters 이 옵션은 --cluster-id와 조합하여 설정해야 합니다.

필수 여부: 아니요

-- hsm-ca-cert <HsmCA Certificate Filepath>

HSM CA 인증서의 파일 경로를 지정합니다.

필수 여부: 아니요

--region <Region>

클러스터의 지역을 지정합니다. 이 옵션은 --cluster-id와 조합하여 설정해야 합니다.

--region 파라미터를 제공하지 않으면 시스템은 AWS_DEFAULT_REGION 또는 AWS_REGION 환경 변수를 읽으려고 시도하여 리전을 선택합니다. 이러한 변수가 설정되지 않은 경우, 시스템은 사용자가 AWS_CONFIG_FILE 환경 변수에 다른 파일을 지정하지 않는 한 AWS config 파일(일반적으로 ~/.aws/config)의 프로필과 연결된 리전을 확인합니다. 위 항목 중 아무 것도 설정되지 않은 경우 시스템은 us-east-1 리전을 기본값으로 사용합니다.

필수 여부: 아니요

-- server-client-cert-file <Client Certificate Filepath>

TLS 클라이언트-서버 상호 인증에 사용되는 클라이언트 인증서의 경로입니다.

클라이언트 SDK 5에 포함된 기본 키 및 SSL/TLS 인증서를 사용하지 않으려는 경우에만 이 옵션을 사용하세요. 이 옵션은 --server-client-key-file와 조합하여 설정해야 합니다.

필수 여부: 아니요

-- server-client-key-file <Client Key Filepath>

TLS 클라이언트-서버 상호 인증에 사용되는 클라이언트 키의 경로

클라이언트 SDK 5에 포함된 기본 키 및 SSL/TLS 인증서를 사용하지 않으려는 경우에만 이 옵션을 사용하세요. 이 옵션은 --server-client-cert-file와 조합하여 설정해야 합니다.

필수 여부: 아니요

구성-cli 제거-클러스터

CloudHSM CLI로 여러 클러스터에 연결하는 경우 명령을 configure-cli remove-cluster 사용하여 구성에서 클러스터를 제거합니다.

구문

configure-cli remove-cluster [OPTIONS] --cluster-id <CLUSTER ID> [-h, --help]

cluster-id 파라미터와 함께 configure-cli remove-cluster을 사용하여 구성에서 클러스터(ID cluster-1234567)를 삭제합니다.

Linux
$ sudo /opt/cloudhsm/bin/configure-cli remove-cluster --cluster-id cluster-1234567
Windows
C:\Program Files\Amazon\CloudHSM\> .\configure-cli.exe remove-cluster --cluster-id cluster-1234567

--cluster-id 파라미터에 대한 자세한 내용은 파라미터을 참조하세요.

파라미터

--cluster-id <Cluster ID>

구성에서 제거할 클러스터의 ID.

필수 여부: 예

여러 클러스터 사용

CloudHSM CLI로 여러 클러스터를 구성한 후 명령을 cloudhsm-cli 사용하여 해당 클러스터와 상호 작용합니다.

cluster-id매개 변수와 대화형 모드 함께 를 사용하여 구성에서 기본 클러스터 (ID 포함cluster-1234567) 를 설정합니다.

Linux
$ cloudhsm-cli interactive --cluster-id cluster-1234567
Windows
C:\Program Files\Amazon\CloudHSM\> .\cloudhsm-cli.exe interactive --cluster-id cluster-1234567

cluster-id파라미터를 사용하여 클러스터 hsm-정보 가져올 클러스터 (ID 포함cluster-1234567) 를 설정합니다.

Linux
$ cloudhsm-cli cluster hsm-info --cluster-id cluster-1234567
Windows
C:\Program Files\Amazon\CloudHSM\> .\cloudhsm-cli.exe cluster hsm-info --cluster-id cluster-1234567