Passare il Workspace Community di ONLYOFFICE al protocollo HTTPS

Introduzione

Nella maggior parte dei casi, accedere al portale tramite il protocollo HTTPS è molto più sicuro che tramite HTTP, utilizzato per impostazione predefinita. Tuttavia, per cambiare il metodo di accesso al portale è necessario eseguire alcune azioni. Segui i passaggi seguenti per scoprire come passare il tuo ONLYOFFICE Workspace a HTTPS.

Creazione di un certificato di sicurezza e di una chiave privata

Prima di poter iniziare a passare il tuo ONLYOFFICE Workspace Community a HTTPS, dovrai creare un certificato di sicurezza e la chiave privata del certificato.

Per generare automaticamente un certificato SSL utilizzando il servizio letsencrypt, consulta questo articolo.

Una volta ottenuto il certificato, procedi con i passaggi seguenti.

Passare ONLYOFFICE Workspace Community a HTTPS utilizzando lo script

Il modo più rapido per passare ONLYOFFICE Workspace Community a HTTPS è utilizzare lo script. Si trova qui:

/var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

Inserisci i certificati creati nella directory /var/www/onlyoffice/Data/certs/. Devono esserci due file:

• /var/www/onlyoffice/Data/certs/onlyoffice.crt
• /var/www/onlyoffice/Data/certs/onlyoffice.key

Quindi esegui lo script:

sudo bash /var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

Farà tutto il necessario per passare la tua installazione di ONLYOFFICE Workspace Community a HTTPS.

Passare ONLYOFFICE Workspace Community a HTTPS manualmente

Puoi eseguire manualmente tutte le azioni dello script. Per farlo, segui i passaggi seguenti:

1. Arresta il servizio NGINX:

   sudo service nginx stop

2. Copia il file /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template nel file /etc/nginx/sites-available/onlyoffice per i sistemi basati su Debian o in /etc/nginx/conf.d/onlyoffice.conf per i sistemi basati su RPM.

   Usa il seguente comando per i sistemi basati su Debian:

   sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/sites-available/onlyoffice

   Usa il seguente comando per i sistemi basati su RPM:

   sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/conf.d/onlyoffice.conf

3. Modifica il file /etc/nginx/sites-available/onlyoffice per i sistemi basati su Debian o il file /etc/nginx/conf.d/onlyoffice.conf per i sistemi basati su RPM. Cambia tutti i parametri tra doppie parentesi graffe {{...}} con i valori effettivamente utilizzati:

   • {{SSL_CERTIFICATE_PATH}}: il percorso del certificato SSL che hai;
   • {{SSL_KEY_PATH}}: il percorso della chiave privata del certificato SSL;
   • {{SSL_VERIFY_CLIENT}}: se la verifica dei certificati client è abilitata (con i valori disponibili on, off, optional e optional_no_ca);
   • {{CA_CERTIFICATES_PATH}}: il percorso del certificato client, che verrà verificato se abilitato con il parametro precedente;
   • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}}: un'opzione di configurazione avanzata per impostare il max-age di HSTS nella configurazione del vHost NGINX di ONLYOFFICE Workspace Community, applicabile solo quando si usa SSL (di solito il valore predefinito è 31536000, considerato abbastanza sicuro);
   • {{SSL_DHPARAM_PATH}}: il percorso del parametro Diffie-Hellman;
   • {{ONLYOFFICE_NGINX_KEEPLIVE}}: il numero massimo di connessioni keep-alive inattive verso i server upstream che vengono conservate nella cache di ogni processo di lavoro (per ulteriori informazioni su questo parametro, consulta la documentazione di NGINX);
   • {{DOCKER_ONLYOFFICE_SUBNET}}: il valore della subnet interna di Docker (se ONLYOFFICE Workspace Community è installato tramite Docker);
   • {{SSL_OCSP_CERTIFICATE_PATH}}: il percorso di un file con certificati CA attendibili in formato PEM utilizzato per verificare i certificati client e le risposte OCSP (Online Certificate Status Protocol) se ssl_stapling è abilitato.

   Consulta la documentazione di NGINX per ulteriori informazioni sui parametri SSL utilizzati nel file di configurazione.

4. Apri il file di configurazione /var/www/onlyoffice/Services/MailAggregator/ASC.Mail.Aggregator.CollectionService.exe.config e imposta il valore del parametro mail.default-api-scheme su https. Dopodiché riavvia il servizio dell'aggregatore di posta:

   onlyofficeMailAggregator restart

5. Passa Talk al protocollo TLS.

6. Una volta apportate tutte le modifiche, puoi avviare di nuovo il servizio NGINX:

   sudo service nginx start

   note

   La porta 443 deve essere aperta per il corretto funzionamento del portale.