Introduzione
Questo articolo descrive la configurazione dei certificati SSL personalizzati nell'area Gestione domini della piattaforma.
I certificati SSL sono necessari in piattaforma per proteggere i domini personalizzati e secondari.
Durante la configurazione di un dominio personalizzato o di un dominio secondario in piattaforma, è possibile utilizzare un certificato gestito dalla piattaforma oppure un certificato SSL personalizzato acquistato autonomamente:
- Se si sceglie un certificato gestito dalla piattaforma, non è necessario eseguire le configurazioni descritte in questo articolo. La piattaforma si occuperà direttamente della creazione, del caricamento, della distribuzione e del rinnovo del certificato del dominio.
- Se invece si desidera utilizzare un certificato SSL personalizzato, è necessario seguire i passaggi descritti in questo articolo per aggiungere il certificato alla piattaforma.
Una volta completata questa operazione, durante la configurazione del dominio personalizzato o secondario sarà possibile selezionare il certificato aggiunto in precedenza da un menu a tendina.
Prerequisiti
La configurazione dei certificati SSL è disponibile se in piattaforma è attiva la funzionalità dominio personalizzato o la funzionalità Extended enterprise.
Se nessuna delle due funzionalità è attiva, non è necessario configurare i certificati SSL.
Preparare un certificato SSL per un dominio
Questo capitolo illustra tutti i passaggi da completare prima di poter caricare un certificato SSL in piattaforma.
Nome dominio da proteggere con il certificato:
È necessario avere già acquisito la proprietà del nome dominio che si desidera proteggere con un certificato SSL. In genere, ciò avviene tramite il proprio fornitore del servizio di registrazione o il dipartimento IT aziendale.
→ Il nome dominio utilizzato può essere compreso tra il 3° e il 5° livello e non deve coincidere con alcun dominio mittente email in uso. Per maggiori informazioni, consultare gli articoli dedicati ai domini personalizzati o ai domini secondari.
Configurazione DNS del dominio:
Prima di richiedere un certificato SSL, la configurazione DNS del dominio deve essere completata correttamente, con un record CNAME corretto e, se applicabile, un record CAA.
➢ Consultare l'articolo Gestione domini: requisiti di configurazione DNS.
In caso contrario, l'autorità di certificazione (CA) non sarà in grado di emettere un certificato SSL per il dominio.
Acquistare il certificato SSL per il dominio:
Successivamente, è necessario acquistare da un'autorità di certificazione (CA), come Digicert o Comodo, un certificato SSL emesso per il proprio dominio (o per un dominio wildcard corrispondente).
Attenzione! Si tratta di una funzionalità tecnica. In caso di scarsa familiarità con questa procedura, contattare il proprio fornitore di certificati, il dipartimento IT aziendale o un partner di fiducia per ricevere assistenza.
Al momento dell'acquisto di un certificato, viene generalmente richiesto di inviare un file di Richiesta firma certificato (CSR), contenente il nome o i nomi comuni da proteggere con il certificato, le informazioni sulla propria azienda e la propria chiave pubblica.
→ La piattaforma non offre alcuno strumento per generare un file CSR. Tuttavia, è possibile generare il CSR utilizzando strumenti come OpenSSL.
Durante la generazione del CSR, è necessario specificare il nome comune: si tratta del nome di dominio completo da proteggere con il certificato. Ad esempio, learning.mycompany.com. In caso di richiesta di un certificato wildcard, aggiungere un asterisco * a sinistra del nome comune, nel punto in cui si desidera il carattere jolly. Ad esempio, *.mydomain.com.
Alcuni registrar e fornitori di certificati richiedono di scegliere il tipo di server web su cui è ospitato il sito per procedere con la procedura di registrazione. In questi casi, scegliere o inserire Apache come tipo di server di hosting.
Nota sui certificati autofirmati:
L'utilizzo di certificati autofirmati causa errori nelle funzionalità della piattaforma. Docebo consiglia di acquistare un certificato SSL da un'autorità di certificazione, come indicato in precedenza, per offrire un'esperienza utente ottimale.
Preparare i file del certificato .PEM per il caricamento:
Al momento dell'acquisto di un certificato SSL, l'autorità di certificazione fornisce uno o più file che possono essere in formato CRT, DER, PEM o in un altro formato:
- Un file del certificato primario, che contiene la chiave pubblica e le informazioni di convalida del dominio: ad esempio,
<yourdomain_name>.crt - Il file del certificato intermedio (uno o più), contenenti i certificati intermedi necessari per la catena di fiducia: ad esempio,
<Intermediate>.crt
Sarà inoltre necessario disporre di:
- Un file chiave privata, ad es.
<Your_Domain_Name>.key. Questo file non viene fornito dalla CA, ma viene generato sul proprio server al momento della creazione della Richiesta firma certificato (CSR)
Questi file devono essere convertiti in formato PEM prima di poter essere caricati in piattaforma.
→ È possibile effettuare la conversione utilizzando OpenSSL o un altro strumento.
Nello specifico, il formato richiesto è: esclusivamente formato PEM, con estensione file .pem, all'interno di un file di testo. Ciò significa che il file può essere aperto con qualsiasi editor di testo semplice, come Blocco note (per Windows) e TextEdit (per MacOS), per verificare che sia nel formato corretto:
Il file del certificato PEM deve iniziare e terminare con i seguenti tag e non deve contenere testo al di fuori di essi:
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----Analogamente, il file chiave privata PEM deve iniziare e terminare con i seguenti tag:
-----BEGIN RSA PRIVATE KEY-----
-----END RSA PRIVATE KEY-----Il testo compreso tra i tag di inizio e fine deve essere composto da righe di esattamente 64 caratteri, con l'ultima riga contenente 64 caratteri o meno (secondo le specifiche del formato PEM (si apre in una nuova scheda))
Aggiungere un certificato SSL alla piattaforma
Prima di poter assegnare un certificato a un dominio, è necessario aggiungerlo all'area Gestione domini della piattaforma.
Dopo aver preparato i file del certificato come descritto nel capitolo Preparare un certificato SSL per un dominio, selezionare Menu di navigazione > Configurazione (icona della chiave inglese) > Configurazione e strumenti della piattaforma > Gestione domini. Quindi cliccare sull'icona più nell'angolo in alto a destra della finestra e selezionare l'opzione Nuovo certificato SSL.
Nel pannello che si apre, inserire un Nome per il certificato. Il nome non ha alcun legame con il certificato e serve unicamente come riferimento. Quindi, nella sezione Parametri, caricare i file in formato PEM con estensione .pem preparati in precedenza:
- I file obbligatori Certificato SSL e Chiave privata
- E, facoltativamente, il file CA intermedio.
Dopo aver aggiunto i file, cliccare su Crea e modifica per continuare. Nella pagina che si apre, la scheda Proprietà riepiloga il certificato caricato. Tutte le informazioni presenti sono di sola lettura, ad eccezione del Nome del certificato.
- Nella sezione Generale è possibile verificare il Nome e i file del certificato.
- Nella sezione Dettagli è possibile controllare l'Issuer del certificato, le date di Validità e i Nomi DNS per cui è possibile utilizzare il certificato. Tutte queste proprietà dipendono dai file PEM caricati.
Attenzione! I certificati wildcard sono supportati dalla funzionalità Gestione domini. È possibile aggiungere un certificato wildcard e utilizzarlo per tutti i domini che corrispondono al modello, senza dover ricaricare il certificato per ogni dominio necessario.
→ Una volta aggiunto, il certificato sarà elencato nella scheda Certificati SSL della pagina Gestione domini e sarà possibile assegnarlo a un dominio.
Visualizzare i certificati SSL
Per visualizzare l'elenco dei certificati, selezionare Menu di navigazione > Configurazione (icona della chiave inglese) > Configurazione e strumenti della piattaforma > Gestione domini, quindi, nella pagina Gestione domini, selezionare la scheda Certificati SSL.
È possibile filtrare l'elenco dei certificati per mostrare solo quelli non assegnati ad alcun dominio:
- Nell'angolo in alto a sinistra dell'elenco, cliccare sull'icona del filtro e selezionare la casella Senza domini assegnati.
- Cliccare su Cancella i filtri attivi per tornare a visualizzare tutti i certificati.
È inoltre possibile inserire del testo nella casella Cerca… per trovare rapidamente un certificato specifico.
Per personalizzare le colonne visualizzate, nell'angolo in alto a sinistra dell'elenco cliccare sull'icona delle colonne e selezionare le colonne da mostrare. Deselezionando una casella, la colonna associata viene nascosta.
Per ogni certificato, l'elenco mostra lo stato (valido, scaduto, in scadenza), le informazioni sulla validità e il numero di domini a cui è assegnato. Per visualizzare tutte le informazioni su un certificato, cliccare sul suo nome nell'elenco.
- La scheda Proprietà contiene due sezioni, Generale e Dettagli. Questi campi sono tutti di sola lettura, ad eccezione del Nome del certificato.
- La scheda Domini assegnati elenca i domini a cui il certificato è attualmente assegnato.
Assegnare un certificato SSL a un dominio
Dopo aver aggiunto un certificato SSL, è possibile assegnarlo a un dominio come segue:
- Nell'elenco dei certificati SSL, individuare il certificato da utilizzare e, nella colonna Domini assegnati, cliccare sull'icona del globo.
- Nella scheda Domini assegnati viene ora visualizzato l'elenco degli eventuali domini che utilizzano attualmente questo certificato.
- Per aggiungere un dominio, cliccare sull'icona più nell'angolo in alto a destra e selezionare Assegna dominio. Quindi selezionare il dominio e cliccare su Assegna.
→ È possibile selezionare solo i domini che corrispondono a questo certificato e a cui non è già assegnato un altro certificato.
Un metodo alternativo consiste nell'assegnare il certificato dalla scheda dei domini:
- Nella pagina Gestione domini:
- per il dominio principale, andare alla scheda Dominio principale
- per un dominio secondario, andare alla scheda Domini secondari e, sulla riga del dominio, cliccare su icona ellipsis > Modifica - Scorrere fino alla sezione Certificato SSL, selezionare l'opzione Certificato SSL personalizzato, quindi selezionare dal menu a tendina il certificato da assegnare.
→ È possibile selezionare solo i certificati che corrispondono al dominio.
Attenzione! Un certificato può essere assegnato a un dominio se il nome comune nel file del certificato, o uno dei suoi nomi alternativi del soggetto (SAN), corrisponde al dominio, in modo esatto o tramite un modello wildcard.
Lo stesso certificato può essere assegnato a più domini, tuttavia a ogni dominio può essere assegnato un solo certificato.
Dopo aver assegnato il certificato SSL, si consiglia di verificare la crittografia del dominio personalizzato utilizzando uno strumento, come quelli indicati di seguito, per confermare che la procedura sia stata completata correttamente:
- Strumenti per certificati TLS/SSL di Digicert (si apre in una nuova scheda)
- Namecheap SSL Checker (si apre in una nuova scheda)
Per garantire un corretto tracciamento del materiale didattico quando si utilizza un dominio personalizzato, assicurarsi che il dominio personalizzato sia completamente protetto tramite HTTPS. Si noti che Docebo supporta HTTP/2 (si apre in una nuova scheda) su TLS 1.2 (si apre in una nuova scheda).
Rimuovere l'assegnazione di un certificato da un dominio
È possibile rimuovere un certificato SSL autogestito da un dominio. In questo caso, verrà emesso automaticamente un certificato gestito dalla piattaforma da utilizzare al suo posto.
- Nell'elenco dei certificati SSL, cliccare sul nome del certificato di cui si desidera rimuovere l'assegnazione, quindi selezionare la scheda Domini assegnati.
- Sulla riga del dominio di cui si desidera rimuovere l'assegnazione, cliccare su icona ellipsis > Rimuovi assegnazione al certificato.
→ Viene visualizzato un avviso che indica che verrà emesso un certificato gestito dalla piattaforma in sostituzione di quello rimosso. - Cliccare su Rimuovi assegnazione per confermare.
Attenzione! I certificati SSL gestiti dalla piattaforma vengono creati tramite il servizio esterno Let’s Encrypt, che prevede un limite di 5 certificati per dominio a settimana. Se questo limite è già stato raggiunto, viene visualizzato il messaggio di errore “Si è verificato un errore durante la generazione del certificato SSL gestito dalla piattaforma” e non è possibile procedere con la rimozione dell'assegnazione.
Sostituire il certificato SSL di un dominio
È necessario sostituire il certificato SSL personalizzato, ad esempio, quando è scaduto.
Inoltre, per modificare le proprietà di un certificato diverse dal Nome, ad esempio per aggiungere un file CA intermedio, non è possibile intervenire sul certificato esistente. Sarà necessario sostituire il certificato:
- Seguire la procedura descritta nel capitolo Aggiungere un certificato SSL per aggiungere un nuovo certificato, caricando file del certificato che includano tutte le modifiche necessarie.
- Quindi, per sostituire il vecchio certificato con quello nuovo:
- per il dominio principale, andare alla scheda Dominio principale
- per un dominio secondario, andare alla scheda Domini secondari e, sulla riga del dominio, cliccare su icona ellipsis > Modifica - Scorrere fino alla sezione Certificato SSL e, dal menu a tendina Certificato SSL, selezionare il nuovo certificato appena aggiunto. Quindi cliccare su Salva le modifiche.
Ripetere questa procedura per tutti gli altri domini che utilizzavano lo stesso certificato.
Attenzione! Non è consigliabile sostituire il certificato eseguendo l'operazione Rimuovi assegnazione per il vecchio certificato e poi l'operazione Assegna per quello nuovo. La rimozione dell'assegnazione, infatti, attiva automaticamente l'emissione di un certificato gestito dalla piattaforma per il dominio, con il rischio di raggiungere il limite di 5 certificati.
Eliminare un certificato SSL
È possibile eliminare un certificato SSL solo se non è assegnato ad alcun dominio.
- Nell'elenco dei certificati SSL, individuare il certificato da eliminare.
→ Se al certificato sono associati dei domini, sarà necessario rimuoverne l'assegnazione da ciascun dominio oppure sostituirlo con un altro certificato. - Passare il mouse sulla riga del certificato e cliccare su icona ellipsis > Elimina. Quindi, nella finestra di dialogo, cliccare nuovamente su Elimina per confermare.
Domande frequenti sulla gestione dei domini
Per le domande frequenti, consultare l'articolo Domain Management: Questions and Answers.