Show Menu
ARGOMENTI×

Gestione delle credenziali HSM

Dalla pagina Gestione archivio attendibili potete gestire le credenziali HSM (Hardware Security Module). Un HSM è un dispositivo PKCS#11 di terze parti che potete utilizzare per generare e memorizzare in modo sicuro le chiavi private. L'HSM protegge fisicamente l'accesso e l'uso delle chiavi private.
Il software client è necessario per comunicare con l'HSM. Il software client HSM deve essere installato e configurato sullo stesso computer dei moduli AEM.
Moduli AEM Le firme digitali possono utilizzare le credenziali memorizzate in un HSM per applicare firme digitali lato server. Seguire le istruzioni riportate in questa sezione per creare un alias per ciascuna credenziale HSM che verrà utilizzata dalle firme digitali. L'alias contiene tutti i parametri richiesti dall'HSM.
Dopo aver modificato la configurazione HSM, riavvia il server moduli AEM.

Creare un alias per una credenziale HSM quando il dispositivo HSM è online

  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM, quindi fate clic su Aggiungi.
  2. Nella casella Nome profilo, digitare una stringa utilizzata per identificare l'alias. Questo valore viene utilizzato come proprietà per alcune operazioni Digital Signatures, ad esempio l'operazione Sign Signature Field.
  3. Nella casella Libreria PKCS11, digitate il percorso completo della libreria client HSM sul server. Ad esempio, c:\Program Files\LunaSA\cryptoki.dll . In un ambiente cluster, questo percorso deve essere identico per tutti i server del cluster.
  4. Fate clic su Test della connettività HSM. Se i moduli AEM sono in grado di connettersi al dispositivo HSM, viene visualizzato un messaggio in cui si informa che l'HSM è disponibile. Fai clic su Avanti.
  5. Utilizzate Nome token, ID slot o Indice elenco slot per identificare la posizione in cui sono memorizzate le credenziali nell'HSM.
    • ​Nome token: Corrisponde al nome della partizione HSM da utilizzare (ad esempio, HSMPART1).
    • ​ID slot: L'ID slot è un identificatore slot del tipo di dati long.
    • ​Indice elenco slot: Se si seleziona Indice elenco slot, impostare le informazioni slot su un numero intero che corrisponde allo slot. Si tratta di un indice basato su 0, il che significa che se il client viene registrato prima con la partizione HSMPART1, HSMPART1 verrà fatto riferimento al valore SlotListIndex 0.
  6. Nella casella Pin token, digitate la password necessaria per accedere alla chiave HSM e fate clic su Avanti.
  7. Nella casella Credenziali, selezionare una credenziale. Fate clic su Salva.

Creare un alias per una credenziale HSM quando il dispositivo HSM è offline

  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM, quindi fate clic su Aggiungi.
  2. Nella casella Nome profilo, digitare una stringa utilizzata per identificare l'alias. Questo valore viene utilizzato come proprietà per alcune operazioni Digital Signatures, ad esempio l'operazione Sign Signature Field.
  3. Nella casella Libreria PKCS11, digitate il percorso completo della libreria client HSM sul server. Ad esempio, c:\Program Files\LunaSA\cryptoki.dll . In un ambiente cluster, questo percorso deve essere identico per tutti i server del cluster.
  4. Selezionate la casella di controllo Creazione profilo offline. Fai clic su Avanti.
  5. Nell'elenco dei dispositivi HSM, selezionare il produttore del dispositivo HSM in cui è memorizzata la credenziale.
  6. Nell'elenco Tipo di slot, selezionare l'ID slot, l'indice slot o il nome token e specificare un valore nella casella Informazioni slot. I moduli AEM utilizzano queste impostazioni per determinare dove sono memorizzate le credenziali nell'HSM.
    • ​Nome token: Corrisponde al nome di una partizione (ad esempio, HSMPART1).
    • ​ID slot: L'ID slot è un numero intero che corrisponde allo slot, che a sua volta corrisponde a una partizione. Ad esempio, il client (server moduli) registrato prima con la partizione HSMPART1. Questo mappa lo slot 1 alla partizione HSMPART1, per questo client. Poiché HSMPART1 è la prima partizione registrata, l'ID slot è 1 e si imposta Slot Info su 1.
      L'ID slot è impostato client per client. Se si registra un secondo computer in una partizione diversa (ad esempio, HSMPART2 sullo stesso dispositivo HSM), lo slot 1 sarà associato alla partizione HSMPART2 per quel client.
    • ​Indice slot: Se si seleziona Indice slot, impostare le informazioni slot su un numero intero che corrisponde allo slot. Si tratta di un indice basato su 0, il che significa che se il client viene registrato prima con la partizione HSMPART1, lo slot 1 viene mappato sull'HSMPART1 per questo client. Poiché HSMPART1 è la prima partizione registrata, l'indice di slot è 0.
  7. Selezionare una delle seguenti opzioni e specificare il percorso:
    • Certificato : (Non richiesto se si utilizza SHA1) Fare clic su Sfoglia e individuare il percorso della chiave pubblica per la credenziale in uso.
    • ​Certificato SHA1: (Non richiesto se si utilizza un certificato fisico) Digitare il valore SHA1 (identificazione personale) del file della chiave pubblica (.cer) per la credenziale in uso. Verificare che non siano presenti spazi utilizzati nel valore SHA1.
  8. Nella casella Password digitare la password necessaria per accedere alla chiave HSM per le informazioni sullo slot, quindi fare clic su Salva.

Visualizza proprietà alias credenziali HSM

  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM.
  2. Fare clic sul nome alias dell'alias della credenziale per visualizzare le proprietà, quindi fare clic su OK.

Verificare lo stato di una credenziale HSM

  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM.
  2. Fare clic sulla casella di controllo accanto alla credenziale che si desidera controllare e fare clic su Controlla stato.
La colonna Stato riflette lo stato corrente della credenziale. In caso di errore, nella colonna Stato viene visualizzata una X rossa. Passate il puntatore del mouse sulla X per visualizzare una descrizione contenente il motivo dell’errore.

Aggiorna proprietà alias credenziali HSM

  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM.
  2. Fare clic sul nome alias dell'alias della credenziale.
  3. Fate clic su Aggiorna credenziali e aggiornate le impostazioni come richiesto.

Reimposta tutte le connessioni HSM

Ripristinare le connessioni aperte a un dispositivo HSM dopo un'interruzione della sessione di rete tra il server moduli e il dispositivo HSM. Ad esempio, le interruzioni possono verificarsi a causa di un'interruzione di rete o del fatto che il dispositivo HSM viene portato offline per un aggiornamento software. Dopo un'interruzione, le connessioni esistenti sono scadenti e qualsiasi richiesta di firma relativa a tali connessioni non riesce. L'opzione Reimposta tutte le connessioni HSM cancella le vecchie connessioni.
  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM.
  2. Fate clic su Reimposta tutte le connessioni HSM.

Eliminare un alias di credenziali HSM

  1. Nella console di amministrazione, fate clic su Impostazioni > Gestione archivio attendibili > Credenziali HSM.
  2. Selezionate le caselle di controllo relative alle credenziali HSM da eliminare, fate clic su Elimina, quindi su OK.

Configurare il supporto HSM remoto

I moduli AEM utilizzano un meccanismo IPC/RPC basato su servizi Web. Questo meccanismo consente ai moduli AEM di utilizzare un HSM installato su un computer remoto. Per utilizzare questa funzionalità, installare il servizio Web sul computer remoto in cui è installato l'HSM. Per ulteriori informazioni, consulta Configurazione del supporto HSM per i moduli AEM ES con Sun JDK sulla piattaforma Windows a 64 bit.
Questo meccanismo non supporta la creazione online di profili HSM o controlli dello stato. Esistono tuttavia due modi per creare profili HSM ed eseguire controlli di stato:
  • Crea una credenziale client di moduli AEM trasmettendola nel Certificato del firmatario. Seguite i passaggi in Configurazione del supporto HSM per i moduli AEM ES con Sun JDK sulla piattaforma Windows a 64 bit. La posizione del servizio Web viene passata come proprietà Credential. Sono supportati anche i profili HSM offline creati utilizzando certificati der o certificati SHA-1 hex. Tuttavia, se avete effettuato l’aggiornamento ai moduli AEM da una versione precedente dei moduli AEM, apportate le modifiche ai client perché le credenziali contenevano le informazioni sul certificato e sul servizio Web.
  • Il percorso del servizio Web è specificato nella console di amministrazione per il servizio Signature. (Vedere Impostazioni del servizio Firma.) In questo caso, il client includeva solo l'alias del profilo HSM nell'archivio delle credenziali. È possibile utilizzare questa opzione senza apportare alcuna modifica al client, anche se è stato effettuato l'aggiornamento ai moduli AEM da una versione precedente dei moduli AEM. Questa opzione non supporta i profili HSM che utilizzano il certificato SHA-1.