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á. # Obtenha um valor de atributo AWS CloudHSM chave usando CMU Use o **getAttribute** comando no AWS CloudHSM cloudhsm\_mgmt\_util (CMU) para obter um valor de atributo para uma chave de todos os módulos de segurança de hardware (HSM) no AWS CloudHSM cluster e gravá-lo em stdout (saída padrão) ou em um arquivo. Somente usuários criptográficos (CUs) podem executar esse comando. *Atributos de chave* são propriedades de uma chave. Eles incluem características, como o tipo de chave, a classe, o rótulo e o ID, e valores que representam ações que você pode realizar na chave, como criptografar, descriptografar, encapsular, assinar e verificar. Você só pode usar **getAttribute** nas chaves que você possui e em chaves que são compartilhadas com você. Você pode executar esse comando ou o comando [getAttribute](#cloudhsm_mgmt_util-getAttribute) na key\_mgmt\_util, que grava um ou todos os valores de atributos de uma chave em um arquivo. Para obter uma lista de atributos e das constantes que os representam, use o comando [listAttributes](key_mgmt_util-listAttributes.md). Para alterar os valores de atributo de chaves existentes, use [setAttribute](key_mgmt_util-setAttribute.md) na key\_mgmt\_util e [setAttribute](cloudhsm_mgmt_util-setAttribute.md) na cloudhsm\_mgmt\_util. Para obter ajuda sobre a interpretação dos principais atributos, consulte [AWS CloudHSM referência de atributo-chave para KMU](key-attribute-table.md). Antes de executar qualquer comando da CMU, você deve iniciar a CMU e fazer login no HSM. Certifique-se de fazer login com o tipo de conta de usuário que possa executar os comandos que você planeja usar. Se você adicionar ou excluir HSMs, atualize os arquivos de configuração do CMU. Caso contrário, as alterações feitas podem não ser efetivas para todos HSMs no cluster. ## Tipo de usuário Os usuários a seguir podem executar este comando. + Usuários de criptografia (CU) ## Sintaxe Como esses comandos não têm parâmetros específicos, insira os argumentos na ordem especificada nos diagramas de sintaxe. ``` getAttribute {{}} {{}} [{{}}] ``` ## Exemplo Este exemplo obtém o valor do atributo extraível de uma chave no HSMs. Você pode usar um comando como esse para determinar se é possível exportar uma chave do HSMs. O primeiro comando usa [listAttributes](cloudhsm_mgmt_util-listAttributes.md) para encontrar a constante que representa o atributo extraível. A saída mostra que a constante de `OBJ_ATTR_EXTRACTABLE` é `354`. Também é possível encontrar essas informações com as descrições dos atributos e seus valores em [AWS CloudHSM referência de atributo-chave para KMU](key-attribute-table.md). ``` aws-cloudhsm> listAttributes Following are the possible attribute values for getAttribute: OBJ_ATTR_CLASS = 0 OBJ_ATTR_TOKEN = 1 OBJ_ATTR_PRIVATE = 2 OBJ_ATTR_LABEL = 3 OBJ_ATTR_TRUSTED = 134 OBJ_ATTR_KEY_TYPE = 256 OBJ_ATTR_ID = 258 OBJ_ATTR_SENSITIVE = 259 OBJ_ATTR_ENCRYPT = 260 OBJ_ATTR_DECRYPT = 261 OBJ_ATTR_WRAP = 262 OBJ_ATTR_UNWRAP = 263 OBJ_ATTR_SIGN = 264 OBJ_ATTR_VERIFY = 266 OBJ_ATTR_DERIVE = 268 OBJ_ATTR_LOCAL = 355 OBJ_ATTR_MODULUS = 288 OBJ_ATTR_MODULUS_BITS = 289 OBJ_ATTR_PUBLIC_EXPONENT = 290 OBJ_ATTR_VALUE_LEN = 353 OBJ_ATTR_EXTRACTABLE = 354 OBJ_ATTR_NEVER_EXTRACTABLE = 356 OBJ_ATTR_ALWAYS_SENSITIVE = 357 OBJ_ATTR_DESTROYABLE = 370 OBJ_ATTR_KCV = 371 OBJ_ATTR_WRAP_WITH_TRUSTED = 528 OBJ_ATTR_WRAP_TEMPLATE = 1073742353 OBJ_ATTR_UNWRAP_TEMPLATE = 1073742354 OBJ_ATTR_ALL = 512 ``` O segundo comando é usado **getAttribute** para obter o valor do atributo extraível da chave com o identificador de chave `262170` no HSMs. Para especificar o atributo extraível, o comando usa `354`, a constante que representa o atributo. Como o comando não especifica um nome de arquivo, **getAttribute** grava a saída em stdout. A saída mostra que o valor do atributo extraível é 1 em todos os HSMs. Esse valor indica que o proprietário da chave pode exportá-la. Quando o valor é 0 (0x0), ele não pode ser exportado do. HSMs Você define o valor do atributo extraível ao criar uma chave, mas não pode alterá-la. ``` aws-cloudhsm> getAttribute 262170 354 Attribute Value on server 0(10.0.1.10): OBJ_ATTR_EXTRACTABLE 0x00000001 Attribute Value on server 1(10.0.1.12): OBJ_ATTR_EXTRACTABLE 0x00000001 Attribute Value on server 2(10.0.1.7): OBJ_ATTR_EXTRACTABLE 0x00000001 ``` ## Argumentos Como esses comandos não têm parâmetros específicos, insira os argumentos na ordem especificada nos diagramas de sintaxe. ``` getAttribute {{}} {{}} [{{}}] ``` **** Especifica o identificador da chave de destino. Você pode especificar apenas uma chave em cada comando. Para obter o identificador de chave de uma chave, use [findKey](key_mgmt_util-findKey.md) na key\_mgmt\_util. Você deve ter a chave especificada ou ela deve ser compartilhada com você. Para encontrar os usuários de uma chave, use [getKeyInfo](key_mgmt_util-getKeyInfo.md)em key\_mgmt\_util. Obrigatório: Sim **** Identifica o atributo. Insira uma constante que represente um atributo, ou `512`, que represente todos os atributos. Por exemplo, para obter o tipo de chave, insira `256`, que é a constante para o atributo `OBJ_ATTR_KEY_TYPE`. Para listar os atributos e suas constantes, use [listAttributes](key_mgmt_util-listAttributes.md). Para obter ajuda sobre a interpretação dos principais atributos, consulte [AWS CloudHSM referência de atributo-chave para KMU](key-attribute-table.md). Obrigatório: Sim **** Grava a saída no arquivo especificado. Insira um caminho de arquivo. Se o arquivo especificado existir, **getAttribute** substitui o arquivo sem aviso prévio. Obrigatório: não Padrão: Stdout ## Tópicos relacionados + [getAttribute](key_mgmt_util-getAttribute.md) em key\_mgmt\_util + [listAttributes](cloudhsm_mgmt_util-listAttributes.md) + [setAttribute](cloudhsm_mgmt_util-setAttribute.md) em cloudhsm\_mgmt\_util + [setAttribute](key_mgmt_util-setAttribute.md) em key\_mgmt\_util + [Referência de atributos de chave](key-attribute-table.md)