Umstellung der ONLYOFFICE Docs Enterprise Edition für Windows auf das HTTPS-Protokoll

Einleitung

In den meisten Fällen ist der Zugriff auf die Editoren über das HTTPS-Protokoll deutlich sicherer als über das standardmäßig verwendete HTTP. Um die Zugriffsmethode der Editoren zu ändern, sind jedoch bestimmte Schritte erforderlich. Befolgen Sie die folgenden Schritte, um zu erfahren, wie Sie Ihre ONLYOFFICE Docs auf das HTTPS-Protokoll umstellen.

Umstellung von ONLYOFFICE Docs v5.3 und höher auf HTTPS

Bevor Sie mit der Umstellung Ihrer ONLYOFFICE Docs auf das HTTPS-Protokoll beginnen können, müssen Sie ein Sicherheitszertifikat und den privaten Zertifikatsschlüssel erstellen. Legen Sie diese in eineт Ordner auf dem Computer ab, auf dem ONLYOFFICE Docs installiert ist.

Sobald Sie das Zertifikat haben, fahren Sie mit den folgenden Schritten fort:

1. Stoppen Sie den Dienst ONLYOFFICE DocumentServer Proxy:

   net stop DsProxySvc

2. Kopieren Sie die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl mit dem folgenden Befehl in die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf:

   COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"

3. Bearbeiten Sie die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf, indem Sie alle Parameter in doppelten geschweiften Klammern {{...}} durch die tatsächlich verwendeten ersetzen:
   Beachten Sie, dass die Backslash-Zeichen ( \ ) wie folgt maskiert werden müssen: С:\\yourfolder\\certificates\\onlyoffice.key oder С:/yourfolder/certificates/onlyoffice.key. Enthält der Pfad Leerzeichen, muss dieser in Anführungszeichen gesetzt werden, z. B.: "С:/yourfolder/my certificates/onlyoffice.key".
   • {{SSL_CERTIFICATE_PATH}} - den Pfad zum SSL-Zertifikat, das Sie erhalten haben;
   • {{SSL_KEY_PATH}} - der Pfad zum privaten Schlüssel des SSL-Zertifikats;
   • {{SSL_VERIFY_CLIENT}} - ob die Überprüfung von Client-Zertifikaten aktiviert ist (mit den verfügbaren Werten on, off, optional und optional_no_ca);
   • {{CA_CERTIFICATES_PATH}} - der Pfad zum Client-Zertifikat, der überprüft wird, wenn er mit dem vorherigen Parameter aktiviert wurde;
   • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - erweiterte Konfigurationsoption zum Festlegen des HSTS-Maximalalters in der ONLYOFFICE Docs NGINX vHost-Konfiguration und nur anwendbar, wenn SSL verwendet wird (normalerweise standardmäßig 31536000, was als ausreichend sicher gilt);
   • {{SSL_DHPARAM_PATH}} - der Pfad zum Diffie-Hellman-Parameter;
   Weitere Informationen zu den in der Konfigurationsdatei verwendeten SSL-Parametern finden Sie in der NGINX-Dokumentation.
4. Wenn alle Änderungen vorgenommen wurden, können Sie den Dienst ONLYOFFICE DocumentServer Proxy erneut starten:

   net start DsProxySvc

   Für den korrekten Portalbetrieb muss Port 443 geöffnet sein.
5. Führen Sie %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat aus.

Umstellung von ONLYOFFICE Docs v4.3–v5.2 auf HTTPS

Um ONLYOFFICE Docs v4.3/v5.2 auf HTTPS umzustellen, müssen Sie alle oben genannten Schritte ausführen. Beachten Sie dabei, dass der zweite und der dritte Schritt unterschiedlich aussehen und wie folgt aussehen müssen:

1. ...
2. Kopieren Sie die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template mit dem folgenden Befehl in die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf:

   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"

3. Bearbeiten Sie die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf, indem Sie alle Parameter in doppelten geschweiften Klammern {{...}} für die tatsächlich verwendeten ändern...
4. ...