

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Attributi chiave Java supportati per AWS CloudHSM Client SDK 5
<a name="java-lib-attributes_5"></a>

Questo argomento fornisce informazioni sugli attributi chiave Java supportati per AWS CloudHSM Client SDK 5. In questo argomento viene descritto come utilizzare un'estensione proprietaria per il provider JCE per impostare attributi chiave. Utilizzare questa estensione per impostare gli attributi della chiave supportati e i relativi valori durante le operazioni seguenti:
+ Generazione delle chiavi
+ Importazione delle chiavi

Per esempi di utilizzo degli attributi chiave, vedi [Esempi di codice per la libreria AWS CloudHSM software per Java for Client SDK 5](java-samples.md).

**Topics**
+ [Comprensione degli attributi](#java-understanding-attributes_5)
+ [Attributi supportati](#java-attributes_5)
+ [Impostazione attributi per una chiave](#java-setting-attributes_5)

## Comprensione degli attributi
<a name="java-understanding-attributes_5"></a>

Gli attributi chiave vengono utilizzati per specificare le operazioni consentite su oggetti chiave, incluse le chiavi pubbliche, private o segrete. Gli attributi e i valori della chiave vengono definiti durante le operazioni di creazione degli oggetti chiave. 

Tuttavia, la Java Cryptography Extension (JCE) non specifica come impostare i valori sugli attributi chiave, pertanto la maggior parte delle operazioni erano consentite per impostazione predefinita. Al contrario, lo standard PKCS\# 11 definisce un set completo di attributi con valori predefiniti più restrittivi. A partire dal provider JCE 3.1, AWS CloudHSM fornisce un'estensione proprietaria che consente di impostare valori più restrittivi per gli attributi di uso comune. 

## Attributi supportati
<a name="java-attributes_5"></a>

Puoi impostare i valori per gli attributi elencati nella tabella sottostante. Come best practice, imposta i valori solo per gli attributi che desideri rendere restrittivi. Se non si specifica un valore, AWS CloudHSM utilizza il valore predefinito specificato nella tabella seguente. Una cella vuota nella colonna Valore predefinito indica che all'attributo non è stato assegnato alcun valore predefinito specifico.


****  
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/cloudhsm/latest/userguide/java-lib-attributes_5.html)

**Nota**  
È possibile ottenere un supporto più ampio per gli attributi nella libreria PKCS \#11. Per ulteriori informazioni, vedi [Attributi PKCS \#11 supportati](pkcs11-attributes.md).

## Impostazione attributi per una chiave
<a name="java-setting-attributes_5"></a>

`KeyAttributesMap` è un oggetto simile a Java Map che puoi utilizzare per impostare i valori degli attributi per gli oggetti chiave. I metodi per la funzione `KeyAttributesMap` sono simili a quelli utilizzati per la manipolazione della mappa Java. 

Per impostare valori personalizzati sugli attributi, sono disponibili due opzioni:
+ Utilizzare i metodi elencati nella tabella seguente
+ Utilizzare i modelli di generatore illustrati più avanti in questo documento

Gli oggetti della mappa attributi supportano i seguenti metodi per impostare gli attributi:


****  

| Operation | Valore restituito | Metodo `KeyAttributesMap` | 
| --- | --- | --- | 
| Ottenere il valore di un attributo chiave per una chiave esistente | Oggetto (contenente il valore) o nulla | **get**(keyAttribute) | 
| Inserire il valore di un attributo chiave  | Il valore precedente associato all'attributo chiave o nulla se non esiste alcuna mappatura per un attributo chiave | **put**(keyAttribute, value) | 
| Compilare i valori per più attributi chiave | N/D | **PutAll** () keyAttributesMap | 
| Rimuovere una coppia chiave-valore dalla mappa degli attributi | Il valore precedente associato all'attributo chiave o *nulla* se non esiste alcuna mappatura per un attributo chiave | **remove**(keyAttribute) | 

**Nota**  
Eventuali attributi non specificati in modo esplicito vengono impostati sui valori predefiniti elencati nella tabella precedente in [Attributi supportati](#java-attributes_5). 

### Impostazione di attributi per una coppia di chiavi
<a name="java-setting-attributes-key-pair"></a>

Utilizza la classe Java `KeyPairAttributesMap` per gestire gli attributi chiave per una coppia di chiavi. `KeyPairAttributesMap` incapsula due oggetti `KeyAttributesMap`; uno per una chiave pubblica e uno per una chiave privata.

Per impostare singoli attributi per la chiave pubblica e la chiave privata separatamente, puoi utilizzare il metodo `put()` sull'oggetto mappa `KeyAttributes` corrispondente per tale chiave. Utilizza il metodo `getPublic()` per recuperare la mappa degli attributi per la chiave pubblica e utilizza `getPrivate()` per recuperare la mappa degli attributi per la chiave privata. Compila il valore di più attributi chiave insieme per coppie di chiavi pubbliche e private utilizzando la `putAll()` con una mappa degli attributi della coppia di chiavi come relativo argomento.