Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Establezca los atributos de AWS CloudHSM las claves mediante KMU
<a name="key_mgmt_util-setAttribute"></a>

Use el **setAttribute** comando de AWS CloudHSM key\_mgmt\_util para convertir una clave que solo es válida en la sesión actual en una clave persistente que existirá hasta que la elimine. El comando realiza esta operación cambiando el valor de atributo de token de la clave (`OBJ_ATTR_TOKEN`) de falso (`0`) a verdadero (`1`). Solo puede cambiar los atributos de claves de su propiedad.

También puede utilizar el comando **setAttribute** de cloudhsm\_mgmt\_util para cambiar la etiqueta, encapsular, desencapsular, cifrar y descifrar atributos.

Antes de ejecutar cualquier comando de key\_mgmt\_util, debe [iniciar key\_mgmt\_util](key_mgmt_util-setup.md#key_mgmt_util-start) e [lniciar sesión](key_mgmt_util-log-in.md) en el HSM como usuario de criptografía (CU). 

## Sintaxis
<a name="setAttribute-syntax"></a>

```
setAttribute -h 

setAttribute -o {{<object handle>}} 
             -a 1
```

## Ejemplo
<a name="setAttribute-examples"></a>

En este ejemplo se muestra cómo convertir una clave de sesión en una clave persistente. 

El primer comando usa el `-sess` parámetro de [genSymKey](key_mgmt_util-genSymKey.md)para crear una clave AES de 192 bits que solo es válida en la sesión actual. La salida muestra que el indicador de la clave de la nueva sesión es `262154`.

```
Command: genSymKey -t 31 -s 24 -l tmpAES -sess
      
        Cfm3GenerateSymmetricKey returned: 0x00 : HSM Return: SUCCESS

        Symmetric Key Created.  Key Handle: 262154

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
```

Este comando utiliza [findKey](key_mgmt_util-findKey.md) para encontrar las claves de sesión de la sesión actual. La salida verifica que la clave `262154` es una clave de sesión.

```
Command:  findKey -sess 1

Total number of keys present 1

 number of keys matched from start index 0::0
262154

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS

        Cfm3FindKey returned: 0x00 : HSM Return: SUCCESS
```

Este comando utiliza **setAttribute** para convertir la clave de sesión `262154` en una clave persistente. Para ello, cambia el valor del atributo de token (`OBJ_ATTR_TOKEN`) de la clave, de `0` (falso) a `1` (verdadero). Para obtener ayuda para interpretar los atributos de clave, consulte la [AWS CloudHSM referencia de atributo clave para KMU](key-attribute-table.md).

El comando utiliza el parámetro `-o` para especificar el indicador de clave (`262154`) y el parámetro `-a` para especificar la constante que representa el atributo de token (`1`). Cuando ejecuta el comando, este le solicita un valor para el atributo de token. El único valor válido es `1` (verdadero), el valor de una clave persistente.

```
Command: setAttribute -o 262154 -a 1
         This attribute is defined as a boolean value.
          Enter the boolean attribute value (0 or 1):1

        Cfm3SetAttribute returned: 0x00 : HSM Return: SUCCESS

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS
```

Para confirmar que la clave `262154` es ahora persistente, este comando busca claves de sesión (`-sess 1`) y claves persistentes (`-sess 0`) utilizando **findKey**. Esta vez el comando no encuentra claves de sesión, pero devuelve `262154` en la lista de claves persistentes.

```
Command: findKey -sess 1

Total number of keys present 0

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS

        Cfm3FindKey returned: 0x00 : HSM Return: SUCCESS



Command: findKey -sess 0

Total number of keys present 5

 number of keys matched from start index 0::4
6, 7, 524296, 9, 262154

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
        Node id 0 and err state 0x00000000 : HSM Return: SUCCESS

        Cfm3FindKey returned: 0x00 : HSM Return: SUCCESS
```

## Parameters
<a name="setAttribute-parameters"></a>

**-h**  
Muestra ayuda para el comando.   
Obligatorio: sí

**-o**  
Especifica el identificador de la clave de destino. Puede especificar una única clave en cada comando. Para obtener el identificador de una clave, use [findKey](key_mgmt_util-findKey.md).  
Obligatorio: sí

**-a**  
Especifica la constante que representa el atributo que desea cambiar. El único valor válido es `1`, que representa el atributo de token `OBJ_ATTR_TOKEN`.  
Para obtener los atributos y sus valores enteros, utilice [listAttributes](key_mgmt_util-listAttributes.md).  
Obligatorio: sí

## Temas relacionados
<a name="setAttribute-seealso"></a>
+ [setAttribute](cloudhsm_mgmt_util-setAttribute.md) en cloudhsm\_mgmt\_util
+ [getAttribute](key_mgmt_util-getAttribute.md)
+ [listAttributes](key_mgmt_util-listAttributes.md)
+ [Referencia de los atributos de claves](key-attribute-table.md)