Conectando-se a vários slots com PKCS#11 - AWS CloudHSM

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conectando-se a vários slots com PKCS#11

Um único slot na biblioteca PKCS #11 do Client SDK 5 representa uma única conexão com um cluster no AWS CloudHSM. Com o Client SDK 5, é possível configurar sua biblioteca PKCS11 para permitir que vários slots conectem usuários a vários clusters do CloudHSM a partir de um único aplicativo PKCS #11.

Use as instruções neste tópico para fazer com que seu aplicativo use a funcionalidade de vários slots para se conectar a vários clusters.

Pré-requisitos de vários slots

  • Dois ou mais AWS CloudHSM clusters aos quais você gostaria de se conectar, junto com seus certificados de cluster.

  • Uma instância do EC2 com grupos de segurança configurados corretamente para se conectar a todos os clusters acima. Para obter mais informações sobre como configurar um cluster e a instância cliente, consulte Introdução ao AWS CloudHSM.

  • Para configurar a funcionalidade de vários slots, você já deve ter baixado e instalado a biblioteca PKCS #11. Se ainda não tiver feito isso, consulte as instruções em Instale a biblioteca PKCS #11 para o Client SDK 5.

Configure a biblioteca PKCS #11 para a funcionalidade de vários slots

Para configurar sua biblioteca PKCS #11 para a funcionalidade de vários slots, siga estas etapas:

  1. Identifique os clusters aos quais você deseja se conectar usando a funcionalidade de vários slots.

  2. Adicione esses clusters à sua configuração PKCS #11 seguindo as instruções em configure-pkcs11 add-cluster

  3. Na próxima vez que seu aplicativo PKCS #11 for executado, ele terá a funcionalidade de vários slots.

configure-pkcs11 add-cluster

Ao se conectar a vários slots com o PKCS #11, 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, você pode especificar o endpoint da AWS CloudHSM API 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.

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 AWS CloudHSM configuração.

nota

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

Obrigatório: Sim

--endpoint <Endpoint>

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

Obrigatório: Não

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

Especifica o caminho do arquivo para o certificado 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 <Client Certificate Filepath>

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 <Client Key Filepath>

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

configure-pkcs11 remove-cluster

Ao se conectar a vários slots com o PKCS #11, use o comando configure-pkcs11 remove-cluster para remover um cluster dos slots PKCS #11 disponíveis.

Sintaxe

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

Exemplos

Use o parâmetro configure-pkcs11 remove-cluster junto com cluster-id para remover um cluster (com o ID de cluster-1234567) da sua configuração.

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

Para obter mais informações sobre o parâmetro --cluster-id, consulte Parâmetros.

Parâmetro

--cluster-id <Cluster ID>

O ID do cluster a ser removido da configuração

Obrigatório: Sim