Passa al contenuto principale

Passaggio di un'installazione Windows di ONLYOFFICE Docs a HTTPS

Introduzione​

Nella maggior parte dei casi, accedere a ONLYOFFICE Docs tramite il protocollo HTTPS è molto più sicuro che tramite HTTP, utilizzato per impostazione predefinita. Per modificare il metodo di accesso agli editor, è necessario eseguire alcune operazioni. Segui i passaggi riportati di seguito per scoprire come passare il tuo ONLYOFFICE Docs al protocollo HTTPS.

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

Prima di 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 in cui è installato ONLYOFFICE Docs.

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

note

Tutti i comandi devono essere eseguiti con privilegi di amministratore. Per avviare un prompt dei comandi come amministratore, fai clic con il pulsante destro del mouse sul pulsante del menu Start nell'angolo inferiore sinistro del desktop e fai clic sull'opzione Prompt dei comandi (amministratore).

  1. Arresta il servizio ONLYOFFICE DocumentServer Proxy:

    net stop DsProxySvc

  2. 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"

  3. Modifica il file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf, sostituendo tutti i parametri tra doppie parentesi graffe {{...}} con i valori effettivi:

    note

    Tieni presente che i caratteri barra rovesciata ( \ ) devono essere preceduti da un carattere di escape in uno dei seguenti modi: C:\\yourfolder\\certificates\\onlyoffice.key oppure C:/yourfolder/certificates/onlyoffice.key. Se nel percorso sono presenti spazi, è necessario racchiuderlo tra virgolette, ad esempio: "C:/yourfolder/my certificates/onlyoffice.key".

    • {{SSL_CERTIFICATE_PATH}} - il percorso del certificato SSL ottenuto;
    • {{SSL_KEY_PATH}} - il percorso della chiave privata del certificato SSL;
    • {{SSL_VERIFY_CLIENT}} - indica 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}} - opzione di configurazione avanzata per impostare il max-age HSTS nella configurazione del vHost NGINX di ONLYOFFICE Docs, applicabile solo quando si utilizza SSL (di solito il valore predefinito è 31536000, considerato sufficientemente sicuro);
    • {{SSL_DHPARAM_PATH}} - il percorso del parametro Diffie-Hellman;

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

  4. Una volta salvate tutte le modifiche, riavvia il servizio ONLYOFFICE DocumentServer Proxy:

    net start DsProxySvc
    note

    Per il corretto funzionamento di ONLYOFFICE Docs la porta 443 deve essere aperta.

  5. Esegui %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

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

note

Queste istruzioni si applicano alle versioni precedenti di ONLYOFFICE Docs (v4.3–v5.2). Ti consigliamo di aggiornare all'ultima versione. Se non puoi aggiornare, segui questi passaggi insieme alle istruzioni principali riportate sopra, tenendo presente che i passaggi 2 e 3 sono diversi, come descritto di seguito.

  1. 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"

  2. Modifica il file %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf, sostituendo tutti i parametri tra doppie parentesi graffe {{...}} con i valori effettivi, come descritto nel passaggio 3 sopra.