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à.
Installare e utilizzare il provider JCE AWS CloudHSM per Client SDK 3
È necessario disporre del client AWS CloudHSM prima di poter utilizzare il provider JCE.
Il client è un daemon che stabilisce una comunicazione end-to-end crittografata con i moduli HSM nel cluster. Il provider JCE comunica localmente con il client. Se non hai installato e configurato il pacchetto client AWS CloudHSM, fallo seguendo i passaggi descritti in Installazione del client (Linux). Dopo aver installato e configurato il client, esegui questo comando per avviarlo.
È supportato solo sui sistemi operativi Linux e altri sistemi operativi compatibili.
Argomenti
Installazione del provider JCE
Utilizza i seguenti comandi per scaricare e installare il provider JCE. Il provider è supportato solo sui sistemi operativi Linux e altri sistemi operativi compatibili.
Nota
Per l'aggiornamento, vedi Aggiornamento del Client SDK 3.
Dopo aver eseguito i comandi precedenti, è possibile individuare i seguenti file della del provider JCE:
-
/opt/cloudhsm/java/cloudhsm-
version
.jar -
/opt/cloudhsm/java/cloudhsm-test-
version
.jar -
/opt/cloudhsm/java/hamcrest-all-1.3.jar
-
/opt/cloudhsm/java/junit.jar
-
/opt/cloudhsm/java/log4j-api-2.17.1.jar
-
/opt/cloudhsm/java/log4j-core-2.17.1.jar
-
/opt/cloudhsm/lib/libcaviumjca.so
Convalida dell'installazione
Esecuzione di operazioni di base sull’HSM per convalidare l'installazione.
Per convalidare l'installazione del provider JCE
-
(Facoltativo) Se non hai già installato Java nell'ambiente, utilizza il comando seguente per installarlo.
-
Utilizza i seguenti comandi per impostare le variabili di ambiente necessarie. Sostituisci
<nome utenteHSM>
e<password>
con le credenziali di un crypto user (CU).$
export LD_LIBRARY_PATH=/opt/cloudhsm/lib
$
export HSM_PARTITION=PARTITION_1
$
export HSM_USER=
<HSM user name>
$
export HSM_PASSWORD=
<password>
-
Utilizza il seguente comando per eseguire il test di funzionalità di base. Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente.
$
java8 -classpath "/opt/cloudhsm/java/*" org.junit.runner.JUnitCore TestBasicFunctionality
JUnit version 4.11 .2018-08-20 17:53:48,514 DEBUG [main] TestBasicFunctionality (TestBasicFunctionality.java:33) - Adding provider. 2018-08-20 17:53:48,612 DEBUG [main] TestBasicFunctionality (TestBasicFunctionality.java:42) - Logging in. 2018-08-20 17:53:48,612 INFO [main] cfm2.LoginManager (LoginManager.java:104) - Looking for credentials in HsmCredentials.properties 2018-08-20 17:53:48,612 INFO [main] cfm2.LoginManager (LoginManager.java:122) - Looking for credentials in System.properties 2018-08-20 17:53:48,613 INFO [main] cfm2.LoginManager (LoginManager.java:130) - Looking for credentials in System.env SDK Version: 2.03 2018-08-20 17:53:48,655 DEBUG [main] TestBasicFunctionality (TestBasicFunctionality.java:54) - Generating AES Key with key size 256. 2018-08-20 17:53:48,698 DEBUG [main] TestBasicFunctionality (TestBasicFunctionality.java:63) - Encrypting with AES Key. 2018-08-20 17:53:48,705 DEBUG [main] TestBasicFunctionality (TestBasicFunctionality.java:84) - Deleting AES Key. 2018-08-20 17:53:48,707 DEBUG [main] TestBasicFunctionality (TestBasicFunctionality.java:92) - Logging out. Time: 0.205 OK (1 test)
Fornire le credenziali al provider JCE
I moduli HSM necessitano di autenticare l'applicazione Java, prima che l'applicazione sia in grado di utilizzarli. Ogni applicazione può utilizzare una sessione. I moduli HSM autenticano una sessione utilizzando un accesso esplicito o un metodo di accesso implicito.
Accesso Esplicito – questo metodo consente di fornire le credenziali CloudHSM direttamente nell'applicazione. Utilizza il metodo LoginManager.login()
, in cui si passa il nome utente, la password e l'ID della partizione HSM. Per ulteriori informazioni sull'utilizzo del metodo di accesso esplicito, vedi l'esempio di codice Accesso a un HSM
Accesso Implicito – questo metodo consente di impostare le credenziali di CloudHSM in un nuovo file di proprietà, proprietà del sistema, oppure come variabili di ambiente.
-
Nuovo file di proprietà Crea un nuovo file con nome
HsmCredentials.properties
e aggiungilo a quello della tua applicazione. Il file deve contenere il testo seguente:HSM_PARTITION = PARTITION_1 HSM_USER =
<HSM user name>
HSM_PASSWORD =<password>
-
Proprietà di sistema – Imposta le credenziali attraverso le proprietà di sistema durante l'esecuzione di un'applicazione. I seguenti esempi mostrano due modi differenti con cui è possibile eseguire questa operazione:
$
java -DHSM_PARTITION=PARTITION_1 -DHSM_USER=
<HSM user name>
-DHSM_PASSWORD=<password>
System.setProperty("HSM_PARTITION","PARTITION_1"); System.setProperty("HSM_USER","
<HSM user name>
"); System.setProperty("HSM_PASSWORD","<password>
"); -
Variabili di ambiente – Imposta le credenziali come variabili di ambiente.
$
export HSM_PARTITION=PARTITION_1
$
export HSM_USER=
<HSM user name>
$
export HSM_PASSWORD=
<password>
Le credenziali potrebbero non essere disponibili se l'applicazione non le fornisce o se viene eseguita un'operazione prima che l’HSM autentichi la sessione. In questi casi, la libreria software CloudHSM per Java cerca le credenziali nel seguente ordine:
-
HsmCredentials.properties
-
Proprietà di sistema
-
Variabili di ambiente
Gestione degli errori
La gestione degli errori è più facile con l'accesso esplicito rispetto al metodo di login implicito. Quando si utilizza la classe LoginManager
, si dispone di un maggiore controllo sulla modalità con cui l'applicazione gestisce gli errori. Il metodo di login implicito complica la gestione degli errori quando le credenziali non sono valide o si sono verificati problemi con i moduli HSM durante la sessione di autenticazione.
Nozioni di base sulla gestione delle chiavi nel provider JCE
Le nozioni di base sulla gestione delle chiavi nel provider JCE implicano l'importazione, l'esportazione di chiavi, il caricamento di chiavi tramite handle, oppure l'eliminazione di chiavi. Per ulteriori informazioni su come gestire le chiavi, vedi l'esempio di codice Gestire le chiavi
Puoi inoltre trovare ulteriori esempi di codice del provider JCE all'indirizzoEsempi di codice.