Passaggio di ONLYOFFICE Docs Enterprise Edition per Windows al protocollo HTTPS

Introduzione

Nella maggior parte dei casi, accedere agli editor tramite protocollo HTTPS è molto più sicuro rispetto all'uso di HTTP, che è il metodo predefinito. Tuttavia, per modificare il metodo di accesso agli editor, è necessario eseguire alcune azioni. Segui i passaggi seguenti per scoprire come passare il tuo ONLYOFFICE Docs al protocollo HTTPS.

Passaggio di ONLYOFFICE Docs v5.3 e versioni successive a HTTPS

Prima di poter iniziare a passare il tuo ONLYOFFICE Docs al protocollo HTTPS, dovrai creare un certificato di sicurezza e la chiave privata del certificato. Inseriscili in una cartella sul computer dove è installato ONLYOFFICE Docs.

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

Tutti i comandi devono essere eseguiti con privilegi amministrativi. Per avviare un prompt dei comandi come amministratore, fai clic con il tasto destro sul pulsante del menu Start nell'angolo in basso a sinistra del desktop e seleziona l'opzione Prompt dei comandi (Admin).

Arresta il servizio ONLYOFFICE DocumentServer Proxy:
```
net stop DsProxySvc
```
Copia il file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl nel file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf utilizzando il seguente comando:
```
COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"
```
Modifica il file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf cambiando tutti i parametri tra doppie parentesi graffe {{...}} con quelli effettivamente utilizzati:
Si prega di notare che i caratteri di barra rovesciata ( \ ) devono essere scappati in uno dei seguenti modi: С:\yourfolder\certificates\onlyoffice.key o С:/yourfolder/certificates/onlyoffice.key. Se ci sono spazi nel percorso, è necessario racchiuderlo tra virgolette, ad esempio: "С:/yourfolder/my certificates/onlyoffice.key".
- {{SSL_CERTIFICATE_PATH}} - il percorso al certificato SSL che hai ottenuto;
- {{SSL_KEY_PATH}} - il percorso alla chiave privata del certificato SSL;
- {{SSL_VERIFY_CLIENT}} - se la verifica dei certificati client è abilitata (con valori disponibili di on, off, optional e optional_no_ca);
- {{CA_CERTIFICATES_PATH}} - il percorso al certificato client, che verrà verificato se abilitato con il parametro precedente;
- {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - opzione di configurazione avanzata per impostare il max-age HSTS nella configurazione vHost di NGINX di ONLYOFFICE Docs, applicabile solo quando SSL è in uso (di solito predefinito a 31536000 considerato abbastanza sicuro);
- {{SSL_DHPARAM_PATH}} - il percorso al parametro Diffie-Hellman;
Si prega di consultare la documentazione di NGINX per ulteriori informazioni sui parametri SSL utilizzati nel file di configurazione.
Quando tutte le modifiche sono state apportate, puoi riavviare il servizio ONLYOFFICE DocumentServer Proxy:
```
net start DsProxySvc
```
La porta 443 deve essere aperta per il corretto funzionamento del portale.
Esegui %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

Passaggio di ONLYOFFICE Docs v4.3–v5.2 a HTTPS

Per passare ONLYOFFICE Docs v4.3/v5.2 a HTTPS, è necessario eseguire tutti i passaggi sopra, prestando attenzione che il secondo e il terzo passaggio saranno diversi e devono essere così:

...
Copia il file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template nel file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf utilizzando il seguente comando:
```
COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf"
```
Modifica il file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf cambiando tutti i parametri tra doppie parentesi graffe {{...}} con quelli effettivamente utilizzati...
...