Adicionar um cluster com funcionalidade de vários slots para AWS CloudHSM - AWS CloudHSM
SintaxeExemplosParâmetros

Adicionar um cluster com funcionalidade de vários slots para AWS CloudHSM

Ao se conectar a vários slots com a PKCS #11 para AWS CloudHSM, use o comando configure-pkcs11 add-cluster para adicionar um cluster à sua configuração.

Sintaxe

configure-pkcs11 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]

Exemplos

Use o parâmetro configure-pkcs11 add-cluster junto com cluster-id para adicionar um cluster (com o ID decluster-1234567) para a sua configuração.

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

Se o uso de configure-pkcs11 add-cluster com o parâmetro cluster-id não resultar na adição do cluster, consulte o exemplo a seguir para obter uma versão mais longa deste comando que também requer os parâmetros --region e --endpoint para identificar o cluster que está sendo adicionado. Se, por exemplo, a região do cluster for diferente daquela configurada como padrão da AWS CLI, você deverá usar o parâmetro --region para usar a região correta. Além disso, é possível especificar o endpoint da API AWS CloudHSM a ser usado na chamada, o que pode ser necessário para várias configurações de rede, como usar endpoints de interface VPC que não usam o nome de host DNS padrão para AWS CloudHSM.

Use configure-pkcs11 add-cluster junto com os parâmetros cluster-id, endpoint e region para adicionar um cluster (com o ID de cluster-1234567) à sua configuração.

Linux

        $ sudo /opt/cloudhsm/bin/configure-pkcs11 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-pkcs11.exe add-cluster --cluster-id cluster-1234567--region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com

Para obter mais informações sobre os parâmetros --endpoint, --cluster-id e --region, consulte Parâmetros de configuração do Client SDK 5 do AWS CloudHSM.

Parâmetros

--cluster-id <Cluster ID>

Faz uma chamada DescribeClusters para encontrar todos os endereços IP da interface de rede elástica (ENI) do HSM no cluster associado ao ID do cluster. O sistema adiciona os endereços IP ENI aos arquivos de configuração AWS CloudHSM.

nota

Se você usar o parâmetro --cluster-id de uma instância do EC2 em uma VPC que não tem acesso à Internet pública, deverá criar uma interface de endpoint da VPC à qual se conectar com AWS CloudHSM. Para obter mais informações sobre os endpoints da VPC, consulte AWS CloudHSM e endpoints da VPC.

Obrigatório: Sim

--endpoint <Endpoint>

Especifique o endpoint do AWS CloudHSM da API usado para fazer a chamada DescribeClusters. Você deve definir essa opção em combinação com --cluster-id.

Obrigatório: Não

--hsm-ca-cert <Caminho de arquivo do certificado da CA do HSM>

Especifica o caminho de arquivo do certificado de CA do HSM.

Obrigatório: Não

--region <Region>

Especifique a região do seu cluster. Você deve definir essa opção em combinação com --cluster-id.

Se você não fornecer o parâmetro --region, o sistema escolherá a região tentando ler as variáveis de ambiente AWS_DEFAULT_REGION ou AWS_REGION. Se essas variáveis não estiverem definidas, o sistema verificará a região associada ao seu perfil no seu arquivo de AWS Config (normalmente ~/.aws/config), a menos que você tenha especificado um arquivo diferente na variável de ambiente AWS_CONFIG_FILE. Se nenhuma das opções acima for definida, o sistema usará a região us-east-1 como padrão.

Obrigatório: Não

--server-client-cert-file <Caminho de arquivo do certificado do cliente>

Caminho para o certificado de cliente usado para autenticação mútua entre cliente e servidor TLS.

Use essa opção somente se não quiser usar a chave padrão e o certificado SSL/TLS que incluímos no Client SDK 5. Você deve definir essa opção em combinação com --server-client-key-file.

Obrigatório: Não

--server-client-key-file <Caminho de arquivo da chave do cliente>

Caminho para a chave do cliente usada para autenticação mútua entre cliente e servidor TLS.

Use essa opção somente se não quiser usar a chave padrão e o certificado SSL/TLS que incluímos no Client SDK 5. Você deve definir essa opção em combinação com --server-client-cert-file.

Obrigatório: Não