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.
Tópicos
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:
Identifique os clusters aos quais você deseja se conectar usando a funcionalidade de vários slots.
Adicione esses clusters à sua configuração PKCS #11 seguindo as instruções em configure-pkcs11 add-cluster
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.
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.
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 ambienteAWS_DEFAULT_REGION
ouAWS_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 ambienteAWS_CONFIG_FILE
. Se nenhuma das opções acima for definida, o sistema usará a regiãous-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.
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