Artikel zum Thema:
Schließen
Changelog
Schließen
In der cloud testen
In der cloud testen
Hilfe-Center
Integration

Über die ONLYOFFICE- und HumHub-Integration

ONLYOFFICE bietet einen offiziellen Konnektor, um ONLYOFFICE Docs mit HumHub zu integrieren und Office-Dokumente innerhalb des sozialen Netzwerks zu bearbeiten. Sie können den ONLYOFFICE-Konnektor vom offiziellen Humhub Marketplace oder der ONLYOFFICE GitHub-Seite herunterladen.

Um mehr über die Funktionsweise des ONLYOFFICE-Konnektors für HumHub zu erfahren, besuchen Sie bitte unsere API-Dokumentation.

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.

Verbinden von ONLYOFFICE Docs mit HumHub

Anforderungen

  • ONLYOFFICE Docs (Document Server) 5.9.4 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.3 und höher
  • ONLYOFFICE-Konnektor 2.2.2 für HumHub

Installieren des ONLYOFFICE-Konnektors für HumHub

Sie können die neueste Konnektor-Version vom offiziellen Humhub Marketplace herunterladen und konfigurieren. Befolgen Sie dazu bitte diese Schritte:

  • Melden Sie sich als Administrator bei Ihrer Humhub-Instanz an.
  • Klicken Sie auf das Drop-Down-Feld im Profil und wählen Sie die Option Administration. Das Fenster User administration wird geladen.
  • Klicken Sie links auf der Seite auf den Abschnitt Modules.
  • Öffnen Sie den Abschnitt Browse online und finden Sie den ONLYOFFICE connector über die Suche. Die Ergebnisse umfassen die Versionen, die mit Ihrer Humhub-Instanz kompatibel sind.
  • Klicken Sie auf die Schaltfläche Install, um das ONLYOFFICE-Modul herunterzuladen und zu installieren.
  • Klicken Sie nach der Installation des Moduls auf die Schaltfläche Enable.
    ONLYOFFICE_installieren ONLYOFFICE_installieren

Konfigurieren des ONLYOFFICE-Konnektors für HumHub

  1. Gehen Sie zu Administration -> Modules -> Installed.
  2. Finden Sie das Modul ONLYOFFICE Connector for HumHub.
  3. Klicken Sie auf die Schaltfläche Configure.
  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).
    • JWT Secret: Geben Sie den Schlüssel an, der zum Signieren der Daten verwendet wird. Weitere Information finden Sie im Abschnitt Aktivieren von JWT für die ONLYOFFICE- und HumHub-Integration in diesem Artikel.
  5. ONLYOFFICE Docs address for internal requests from the 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: Geben Sie die Adresse an, die für den Zugriff auf HumHub vom Document Editing Service verwendet wird.
menü_konfigurieren menü_konfigurieren

Klicken Sie nach der Konfiguration der Integrationsanwendung auf die Schaltfläche Submit, 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
  2. Aktivieren Sie die Token-Validierung, indem Sie den Wert false in drei Abschnitten in true ändern:
    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox
  3. Geben Sie Ihren eigenen geheimen Schlüssel an, indem Sie den geheimen Wert in drei Abschnitten durch Ihre eigene Textzeichenfolge ersetzen. Der geheime Schlüssel muss derselbe sein.
    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string
    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }
    
  4. Speichern Sie Ihre Änderungen.
  5. 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 Secret Key an und speichern Sie die Einstellungen.

Verwendung von ONLYOFFICE Docs in HumHub

Um ein Dokument zu erstellen:

  1. Öffnen Sie die Registerkarte Files.
  2. Klicken Sie auf die Schaltfläche Add file(s).
  3. Klicken Sie auf die Option Create document.
    ONLYOFFICE_erstellen1 ONLYOFFICE_erstellen1
  4. Wählen Sie im geöffneten Fenster den Dateityp: Dokument, Tabellenkalkulation oder Präsentation.
    ONLYOFFICE_erstellen2 ONLYOFFICE_erstellen2
  5. Geben Sie den Dateinamen an.
  6. Aktivieren Sie das Kontrollkästchen Open the new document in the next step, um mit der Arbeit mit dem Dokument zu beginnen.
  7. Klicken Sie auf die Schaltfläche Save.
    ONLYOFFICE_erstellen3 ONLYOFFICE_erstellen3

Um ein Dokument anzuzeigen/zu bearbeiten:

  1. Öffnen Sie die Registerkarte Files.
  2. Klicken Sie auf die gewünschte Datei.
  3. Klicken Sie im geöffneten Fenster auf die Schaltfläche Edit document.
    ONLYOFFICE_bearbeitenanzeigen ONLYOFFICE_bearbeitenanzeigen
Herunterladen Beste Editoren auf Ihrer Webseite Lassen Sie Ihre Seite-Benutzer alle Arten von Text-, Tabellenkalkulations- und Präsentationsdateien
öffnen und gemeinsam bearbeiten
Wer sich dafür interessiert hat,
hat auch das Folgende gelesen:
Schließen