HumHub

Haupteigenschaften

• Erstellen, Bearbeiten und Anzeigen von Textdokumenten, Tabellenkalkulationen und Präsentationen.
• Gemeinsame Bearbeitung von Dokumenten in Echtzeit: zwei Bearbeitungs-Modi (Schnell und Formal). Verfolgen Sie Änderungen und verwenden Sie Kommentare und den integrierten Chat.
• JWT-Unterstützung, um Ihren Datenverkehr zu sichern, damit niemand mit Ausnahme der Benutzer mit den entsprechenden Rechten auf Ihre Dokumente zugreifen können.

Unterstützte Formate

• Erstellen, Bearbeiten und Anzeigen: DOCX, PPTX, XLSX
• Bearbeiten nach Konvertierung in OOXML: ODT, ODS, ODP, DOC, XLS, PPT, TXT, CSV
• Nur Anzeigen: PDF

Was gibt es Neues in Version 2.2.2

Behobene Fehler

• JWT Unterstützung

Das vollständige Änderungsprotokoll ist hier verfügbar.

Anforderungen

• ONLYOFFICE Document Server V. 6.1.0 (die Server- oder Cloud-Lösung) oder höher

  Sie benötigen eine Instanz von ONLYOFFICE Docs, die sowohl von HumHub als auch von beliebigen End-Clients auflösbar und verbindbar ist. Die Instanz muss direkt an HumHub POSTen können

  Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.
• HumHub 1.8 und höher
• ONLYOFFICE-Konnektor 2.4.0 für HumHub

Installieren des ONLYOFFICE-Konnektors für HumHub

Konfigurieren des ONLYOFFICE-Konnektors für HumHub

1. Gehen Sie zu Administration (Verwaltung) -> Modules (Module) -> Installed (Installiert).
2. Finden Sie das Modul ONLYOFFICE Connector for HumHub.
3. Klicken Sie auf die Schaltfläche Configure (Konfigurieren).
4. Geben Sie die folgenden Parameter an:
   • Hostname: Geben Sie die URL-Adresse ein, auf der ONLYOFFICE Docs installiert ist (ONLYOFFICE Docs wird standardmäßig auf Port 80 installiert).
     WichtigDie Adresse von ONLYOFFICE Docs muss über HumHub zugänglich sein, und die Adresse von HumHub muss über ONLYOFFICE Docs zugänglich sein.
   • JWT Secret (JWT-Geheimnis): Geben Sie den Schlüssel an, der zum Signieren der Daten verwendet wird.
     Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen es auch auf der HumHub-Seite aktivieren: Suchen Sie Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs und geben Sie dann denselben geheimen Schlüssel in den Konnektor-Einstellungen an. Weitere Einzelheiten finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und HumHub-Integration dieses Artikels.
5. ONLYOFFICE Docs address for internal requests from the server (ONLYOFFICE Docs-Adresse für interne Anfragen vom Server): Geben Sie die Adresse an, die für den Zugriff auf den Document Editing Service von HumHub verwendet wird.
6. Server address for internal requests from ONLYOFFICE Docs (Serveradresse für interne Anfragen von ONLYOFFICE Docs): Geben Sie die Adresse an, die für den Zugriff auf HumHub vom Document Editing Service verwendet wird.

Klicken Sie nach der Konfiguration der Integrationsanwendung auf die Schaltfläche Submit (Vorlegen), um die Änderungen zu speichern.

Aktivieren von JWT für die ONLYOFFICE- und HumHub-Integration

Um Dokumente vor unbefugtem Zugriff zu schützen, verwenden ONLYOFFICE-Editoren das JSON Web Token (JWT). Das Token wird in der Konfiguration hinzugefügt, wenn der Dokumenteneditor initialisiert wird und während des Austauschs von Befehlen zwischen internen ONLYOFFICE Docs-Diensten. Der geheime Schlüssel wird verwendet, um das JSON-Web-Token zu signieren und das Token auf Anfrage an ONLYOFFICE Docs zu validieren.

Um Ihre Dokumente zu schützen, müssen Sie die Token-Validierung aktivieren und Ihren eigenen geheimen Schlüssel in der ONLYOFFICE Docs-Konfigurationsdatei angeben und dann denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben.

Schritt 1: ONLYOFFICE Docs konfigurieren

1. Öffnen Sie die Datei local.json mit einem beliebigen verfügbaren Texteditor.
   • Für Linux - /etc/onlyoffice/documentserver/local.json
   • Für Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Für Docker – öffnen Sie den ONLYOFFICE Docs-Container mit dem Befehl docker exec -it <containerID> bash und öffnen Sie /etc/onlyoffice/documentserver/local.json

     Sie können auch den folgenden Befehl verwenden, um den geheimen Standardschlüssel zu finden, ohne local.json zu öffnen:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   Die Datei local.json sollte so aussehen:

   {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}

2. Der true-Wert wird in drei Abschnitten angegeben. Dies bedeutet, dass die Token-Validierung aktiviert ist.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. Der automatisch generierte geheime Schlüssel wird in drei Abschnitten angegeben. Sie können den standardmäßigen Geheimwert durch Ihren eigenen Geheimschlüssel ersetzen. Der geheime Schlüssel muss in drei Abschnitten gleich sein.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Wenn Sie Änderungen vornehmen, speichern Sie diese und starten Sie die Dienste neu, damit die Konfigurationsänderungen aktualisiert werden.

   supervisorctl restart all

Schritt 2: Denselben geheimen Schlüssel in den Konnektor-Einstellungen angeben

Geben Sie in den Konnektor-Einstellungen dasselbe Geheimnis im Feld Geheimer Schlüssel an und speichern Sie die Einstellungen.