Riferimento per l'attributo della chiave

I comandi key_mgmt_util utilizzano costanti per rappresentare gli attributi delle chiavi in un HSM. Questo argomento può aiutarti a identificare gli attributi, individuare le costanti che li rappresentano nei comandi e comprenderne i valori.

Puoi impostare gli attributi di una chiave al momento della sua creazione. Per modificare l'attributo token, che indica se una chiave è persistente o se è presente solo nella sessione, utilizza il comando setAttribute in key_mgmt_util. Utilizza il comando setAttribute in cloudhsm_mgmt_util per modificare l'etichetta, eseguire e annullare il wrapping o crittografare e decodificare gli attributi.

Per ottenere un elenco degli attributi e delle relative costanti, utilizza listAttributes. Per ottenere i valori degli attributi di una chiave, utilizza getAttribute.

Nella tabella seguente sono elencati gli attributi della chiave, le relative costanti e i valori validi.

Attributo	Costante	Valori
OBJ_ATTR_ALL	512	Rappresenta tutti gli attributi.
OBJ_ATTR_ALWAYS_SENSITIVE	357	0: Falso. 1: Vero.
OBJ_ATTR_CLASS	0	2: chiave pubblica in una coppia di chiavi pubblica-privata. 3: chiave privata in una coppia di chiavi pubblica-privata. 4: chiave segreta (simmetrica).
OBJ_ATTR_DECRYPT	261	0: Falso. 1: True. La chiave può essere utilizzata per decodificare i dati.
OBJ_ATTR_DERIVE	268	0: Falso. 1: True. La funzione ricava la chiave.
OBJ_ATTR_DESTROYABLE	370	0: Falso. 1: True.
OBJ_ATTR_ENCRYPT	260	0: Falso. 1: True. La chiave può essere utilizzata per crittografare i dati.
OBJ_ATTR_EXTRACTABLE	354	0: Falso. 1: True. La chiave può essere esportata dai moduli HSM.
OBJ_ATTR_ID	258	Stringa definita dall'utente. Deve essere univoca nel cluster. L'impostazione predefinita è una stringa vuota.
OBJ_ATTR_KCV	371	Valore di controllo della chiave. Per ulteriori informazioni, vedi Ulteriori dettagli.
OBJ_ATTR_KEY_TYPE	256	0: RSA. 1: DSA. 3: EC. 16: segreta generica. 18: RC4. 21: Triple DES (3DES). 31: AES.
OBJ_ATTR_LABEL	3	Stringa definita dall'utente. Non è necessario che sia univoca nel cluster.
OBJ_ATTR_LOCAL	355	0. Falso. La chiave è stata importata nei moduli HSM. 1: Vero.
OBJ_ATTR_MODULUS	288	Il modulo utilizzato per creare una coppia di chiavi RSA. Per le chiavi EC, questo valore rappresenta la codifica DER del valore ANSI X9.62 ECPoint "Q" in formato esadecimale. Per altri tipi di chiavi, questo attributo non esiste.
OBJ_ATTR_MODULUS_BITS	289	La lunghezza del modulo utilizzato per creare una coppia di chiavi RSA. Per le chiavi EC, questo rappresenta l'ID della curva ellittica utilizzata per generare la chiave. Per altri tipi di chiavi, questo attributo non esiste.
OBJ_ATTR_NEVER_EXTRACTABLE	356	0: Falso. 1: Vero. La chiave non può essere esportata dai moduli HSM.
OBJ_ATTR_PUBLIC_EXPONENT	290	L'esponente pubblico utilizzato per creare una coppia di chiavi RSA. Per altri tipi di chiavi, questo attributo non esiste.
OBJ_ATTR_PRIVATE	2	0: Falso. 1: Vero. Questo attributo indica se gli utenti non autenticati possono elencare gli attributi della chiave. Poiché il provider CloudHSM PKCS#11 attualmente non supporta le sessioni pubbliche, tutte le chiavi (incluse le chiavi pubbliche di una coppia di chiavi pubblica-privata) hanno l'attributo impostato su 1.
OBJ_ATTR_SENSITIVE	259	0: Falso. Chiave pubblica in una coppia di chiavi pubblica-privata. 1: Vero.
OBJ_ATTR_SIGN	264	0: Falso. 1: Vero. La chiave può essere utilizzata per la firma (chiavi private).
OBJ_ATTR_TOKEN	1	0: Falso. Chiave di sessione. 1: Vero. Chiave persistente.
OBJ_ATTR_TRUSTED	134	0: Falso. 1: Vero.
OBJ_ATTR_UNWRAP	263	0: Falso. 1: Vero. La chiave può essere utilizzata per decodificare le chiavi.
OBJ_ATTR_UNWRAP_TEMPLATE	1073742354	I valori devono utilizzare il modello di attributo applicato a qualsiasi chiave di cui è stato annullato il wrapping utilizzando questa chiave di wrapping.
OBJ_ATTR_VALUE_LEN	353	Lunghezza della chiave in byte.
OBJ_ATTR_VERIFY	266	0: Falso. 1: Vero. La chiave può essere utilizzata per la verifica (chiavi pubbliche).
OBJ_ATTR_WRAP	262	0: Falso. 1: True. La chiave può essere utilizzata per crittografare le chiavi.
OBJ_ATTR_WRAP_TEMPLATE	1073742353	I valori devono utilizzare il modello di attributo per abbinare la chiave sottoposta al wrapping usando questa chiave di wrapping.
OBJ_ATTR_WRAP_WITH_TRUSTED	528	0: Falso. 1: Vero.

Ulteriori dettagli

Valore di controllo della chiave (kcv)

Il valore di controllo chiave (KCV) è un hash o checksum a 3 byte di una chiave che viene generato quando l'HSM importa o genera una chiave. Puoi anche calcolare un KCV al di fuori dell'HSM, ad esempio dopo aver esportato una chiave. È quindi possibile confrontare i valori KCV per confermare l'identità e l'integrità della chiave. Per ottenere il KCV di una chiave, usa getAttribute.

AWS CloudHSM utilizza il seguente metodo standard per generare un valore di controllo chiave:

• Chiavi simmetriche: primi 3 byte del risultato della crittografia di un blocco zero con la chiave.

• Coppie di chiavi asimmetriche: primi 3 byte dell'hash SHA-1 della chiave pubblica.

• Chiavi HMAC: KCV per le chiavi HMAC non è attualmente supportato.