Vai al contenuto principale

Installazione di certificati mTLS per la soluzione Hybrid di docu tools (on-premise)

Aggiornato oltre una settimana fa

Pubblico di riferimento

Questa guida è destinata agli amministratori e agli utenti finali della vostra azienda che utilizzano la variante Hybrid di docu tools, dove l'accesso a uno storage di dati avviene tramite Mutual-TLS (mTLS) e nella finestra di dialogo dell'applicazione web viene offerto il download di un File ca.p7b e di un File client.p12.

Prerequisiti

  • Avete scaricato i File ca.p7b (autorità di certificazione) e client.p12 (certificato client con chiave privata) dalla finestra di dialogo dell'applicazione web.

  • Il File .p12 non è protetto da Password.

  • Utilizzate Windows o macOS con uno dei seguenti browser: Microsoft Edge, Google Chrome.

  • Avete i permessi necessari per Importare certificati.

Nota: Il File ca.p7b contiene il certificato dell'autorità di certificazione, il File client.p12 il certificato client personale e la chiave. Entrambi devono essere installati affinché la connessione mTLS funzioni.


1. Installazione del certificato dell'autorità di certificazione (ca.p7b)

Windows

  1. Aprire il browser → Impostazioni → Privacy e sicurezza → Sicurezza → "Gestire i certificati".

  2. Passare a "Certificati locali" → "Certificati fidati" → "Importare".

  3. Selezionare il File ca.p7b.

  4. Completare l'Import.

macOS

  1. Doppio Click sul File .p7b.

  2. Selezionare il portachiavi "Sistema" o "login".

  3. Confermare l'Import con la Password di macOS.


2. Installazione del certificato client (client.p12)

A) Windows (Edge / Chrome)

  1. Aprire il browser → Impostazioni → Privacy e sicurezza → Sicurezza → "Gestire i certificati".

  2. Passare a "Propri certificati" → "Importare".

  3. Selezionare il File client.p12.

  4. Non essendo necessaria una Password, fare Click direttamente su Avanti.

  5. Completare l'Import.

B) macOS (Edge / Chrome)

  1. Doppio Click sul File client.p12 → si apre l'accesso al portachiavi.

  2. Selezionare il portachiavi "login" o "Sistema".

  3. Non è necessaria una Password → il certificato viene Importato direttamente.

  4. Riavviare il browser → aprire docu tools → selezionare il certificato.


4. Verifica e test

  • Aprire l'applicazione web di docu tools.

  • All'accesso appare una finestra di dialogo per la selezione del certificato.

  • Selezionare il proprio certificato client → l'accesso dovrebbe essere possibile.

Risoluzione dei problemi:

  • Certificato errato o scaduto?

  • Certificato dell'autorità di certificazione non installato?

  • Riavviare il browser?

  • Certificato memorizzato nel posto sbagliato?


5. Rinnovo / Sostituzione dei certificati

  • Rimuovere il vecchio certificato dallo storage dei certificati.

  • Installare il nuovo File client.p12 come descritto sopra.

  • Aggiornare eventualmente il File ca.p7b dell'autorità di certificazione.


6. Errori comuni

  • Certificato memorizzato nel posto sbagliato (es. "Altre persone").

  • .cer invece di .p12 → nessuna chiave privata → non funziona.

  • macOS chiede nel portachiavi "Consenti sempre" → prestare attenzione.


7. Riepilogo

Passaggio

Descrizione

1. Installare la catena di certificati

Importare ca.p7b

2. Installare il certificato client

Importare il File client.p12

3. Testare l'accesso

Aprire docu tools → selezionare il certificato


Per ulteriori domande, si prega di contattare il vostro reparto IT o il supporto di docu tools.

Hai ricevuto la risposta alla tua domanda?