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á. # Associe AWS CloudHSM usuários a chaves usando CMU Use o **registerQuorumPubKey** comando no AWS CloudHSM cloudhsm\_mgmt\_util para associar usuários do módulo de segurança de hardware (HSM) a pares de chaves RSA-2048 assimétricos. Depois de associar usuários do HSM às chaves, esses usuários podem usar a chave privada para aprovar solicitações de quórum e o cluster pode usar a chave pública registrada para verificar se a assinatura pertence ao usuário. Para obter mais informações sobre a autenticação de quórum, consulte [Gerenciar a autenticação de quórum (controle de acesso M of N](quorum-authentication.md)). **dica** *Na AWS CloudHSM documentação, a autenticação de quórum às vezes é chamada de M de N (MoFN), o que significa um mínimo de *M* aprovadores de um número total de N aprovadores.* ## Tipo de usuário Os seguintes tipos de usuários podem executar este comando. + Responsáveis pela criptografia (CO) ## Sintaxe Como esses comandos não têm parâmetros específicos, insira os argumentos na ordem especificada nos diagramas de sintaxe. ``` registerQuorumPubKey {{}} {{}} {{}} {{}} {{}} ``` ## Exemplos Este exemplo mostra como usar **registerQuorumPubKey** para registrar agentes criptográficos (CO) como aprovadores em solicitações de autenticação de quórum. Para executar esse comando, você deve ter um par de chaves RSA-2048 assimétrico, um token assinado e um token não assinado. Para receber mais informações sobre os requisitos, consulte [Argumentos](#registerQuorumPubKey-params). **Example : Registrar um usuário do HSM para autenticação de quórum** Este exemplo registra um CO nomeado `quorum_officer` como aprovador da autenticação de quórum. ``` aws-cloudhsm> registerQuorumPubKey CO {{}} {{}} {{}} {{}} *************************CAUTION******************************** This is a CRITICAL operation, should be done on all nodes in the cluster. AWS does NOT synchronize these changes automatically with the nodes on which this operation is not executed or failed, please ensure this operation is executed on all nodes in the cluster. **************************************************************** Do you want to continue(y/n)?y registerQuorumPubKey success on server 0(10.0.0.1) ``` O comando final usa o comando [listUsers](cloudhsm_mgmt_util-listUsers.md) para verificar se `quorum_officer` está registrado como um usuário MoFN. ``` aws-cloudhsm> listUsers Users on server 0(10.0.0.1): Number of users found:3 User Id User Type User Name MofnPubKey LoginFailureCnt 2FA 1 PCO admin NO 0 NO 2 AU app_user NO 0 NO 3 CO quorum_officer YES 0 NO ``` ## Argumentos Como esses comandos não têm parâmetros específicos, insira os argumentos na ordem especificada nos diagramas de sintaxe. ``` registerQuorumPubKey {{}} {{}} {{}} {{}} {{}} ``` **** Especifica o tipo de usuário. Esse parâmetro é obrigatório. Para obter informações detalhadas sobre os tipos de usuários em um HSM, consulte [Tipos de usuário do HSM para o AWS CloudHSM Management Utility](understanding-users-cmu.md). Valores válidos: + **CO**: Oficiais de criptografia podem gerenciar usuários, mas não conseguem gerenciar chaves. Obrigatório: Sim **** Especifica um nome amigável para o usuário. O tamanho máximo é de 31 caracteres. O único caractere especial permitido é um sublinhado ( \_ ). Não é possível alterar o nome de um usuário após sua criação. Em comandos da cloudhsm\_mgmt\_util, o tipo de usuário e a senha diferenciam maiúsculas de minúsculas, mas o nome do usuário não diferencia. Obrigatório: Sim **** Especifica o caminho para um arquivo que contém um token de registro não assinado. Pode ter qualquer dado aleatório com tamanho máximo de arquivo de 245 bytes. Para obter mais informações sobre como criar um token de registro não assinado, consulte [Criar e assinar um token de registro](quorum-authentication-crypto-officers-first-time-setup.md#mofn-registration-token). Obrigatório: Sim **** Especifica o caminho para um arquivo que contém o hash assinado pelo mecanismo SHA256 \_PKCS do token de registro. Para obter mais informações, consulte [Criar e assinar um token de registro](quorum-authentication-crypto-officers-first-time-setup.md#mofn-registration-token). Obrigatório: Sim **** Especifica o caminho para o arquivo que contém uma chave pública de um par de chaves assimétrico RSA-2048. Use a chave privada para assinar o token de registro. Para obter mais informações, consulte [Criar um par de chaves](quorum-authentication-crypto-officers-first-time-setup.md#mofn-key-pair-create). Obrigatório: Sim O cluster usa a mesma chave para autenticação de quórum e para autenticação de dois fatores (2FA). Isso significa que você não pode alternar uma chave de quórum para um usuário que tenha o 2FA ativado usando **registerQuorumPubKey**. Para alternar a chave, você deve usar **changePswd**. Para obter mais informações sobre como usar a autenticação de quórum e a 2FA, consulte [Autenticação de quórum e 2FA](quorum-2fa.md). ## Tópicos relacionados + [Criar um par de chaves RSA](quorum-authentication-crypto-officers-first-time-setup.md#mofn-key-pair-create) + [Crie e assine um token de registro](quorum-authentication-crypto-officers-first-time-setup.md#mofn-registration-token) + [Registrar uma chave pública no HSM](quorum-authentication-crypto-officers-first-time-setup.md#mofn-register-key) + [Aplicar autenticação de quorum (controle de acesso M de N)](quorum-authentication.md) + [Autenticação de quórum e 2FA](quorum-2fa.md) + [listUsers](cloudhsm_mgmt_util-listUsers.md)