Zum Hauptinhalt springen

Umstellung von ONLYOFFICE Docs für Windows auf das HTTPS-Protokoll

Einleitung​

In den meisten Fällen ist der Zugriff auf ONLYOFFICE Docs über das HTTPS-Protokoll deutlich sicherer als über das standardmäßig verwendete HTTP. Um die Zugriffsmethode der Editoren zu ändern, sind 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 einem Ordner auf dem Computer ab, auf dem ONLYOFFICE Docs installiert ist.

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

hinweis

Alle Befehle sollten mit Administratorrechten ausgeführt werden. Um eine Eingabeaufforderung als Administrator zu starten, klicken Sie mit der rechten Maustaste auf die Start-Schaltfläche in der unteren linken Ecke des Desktops und wählen Sie die Option Eingabeaufforderung (Admin) (Command Prompt (Admin)).

  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ächlichen Werte ersetzen:

    hinweis

    Beachten Sie, dass die Backslash-Zeichen ( \ ) auf eine der folgenden Arten maskiert werden müssen: C:\\yourfolder\\certificates\\onlyoffice.key oder C:/yourfolder/certificates/onlyoffice.key. Enthält der Pfad Leerzeichen, muss dieser in Anführungszeichen gesetzt werden, z. B.: "C:/yourfolder/my certificates/onlyoffice.key".

    • {{SSL_CERTIFICATE_PATH}} - der 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, das überprüft wird, wenn dies 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 gespeichert sind, starten Sie den Dienst ONLYOFFICE DocumentServer Proxy neu:

    net start DsProxySvc
    hinweis

    Für den korrekten Betrieb von ONLYOFFICE Docs 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​

hinweis

Diese Anweisungen gelten für ältere Versionen von ONLYOFFICE Docs (v4.3–v5.2). Wir empfehlen, auf die neueste Version zu aktualisieren. Wenn Sie kein Upgrade durchführen können, führen Sie diese Schritte zusammen mit der obigen Hauptanleitung aus. Beachten Sie dabei, dass sich die Schritte 2 und 3 wie unten beschrieben unterscheiden.

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

  2. Bearbeiten Sie die Datei %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf, indem Sie alle Parameter in doppelten geschweiften Klammern {{...}} wie in Schritt 3 oben beschrieben durch die tatsächlichen Werte ersetzen.