Anforderungen

• ONLYOFFICE Docs (Dokumentenserver) 6.2 oder höher

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

  Weitere Informationen zur Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.
• Chamilo v1.11.14 oder höher

ONLYOFFICE Konnektor für Chamilo installieren

Ab Chamilo v1.11.16 ist der ONLYOFFICE-Konnektor vorinstalliert. Um ihn zu aktivieren, führen Sie die folgenden Schritte aus:

1. Öffnen Sie die Seite Administration von Chamilo und wählen Sie den Abschnitt Plugins im Abschnitt Portal aus.
2. Wählen Sie in der Plugin-Liste das ONLYOFFICE-Plugin aus und klicken Sie auf die Schaltfläche Enable the selected plugins.

Wenn Ihre Chamilo-Version niedriger als 1.11.16 ist, befolgen Sie bitte diese Anweisungen um den ONLYOFFICE-Konnektor zu installieren:

1. Laden Sie den Konnektor von der GitHub-Seite herunter.
2. Öffnen Sie die Seite Administration von Chamilo, wählen Sie Plugins und klicken Sie auf die Schaltfläche Upload plugin.
3. Laden Sie die Datei onlyoffice.zip hoch. Die Plugin-Liste wird angezeigt.
4. Starten Sie composer install mit dem Terminal aus dem Chamilo-Stammordner.
5. Kehren Sie zur Plugin-Liste zurück, wählen Sie das ONLYOFFICE-Plugin aus und klicken Sie auf Enable.

Aktualisieren des ONLYOFFICE-Konnektors für Chamilo

Um den Konnektor auf die neueste Version zu aktualisieren, müssen Sie den vorinstallierten Standard-Plugin-Ordner durch das neue Plugin ersetzen.

Schritt 1: Bereiten Sie den Ordner mit der neuen Version des Konnektors vor.

• Sie können es von der GitHub-Seite herunterladen und das Archiv entpacken:

  cd /tmp && wget https://github.com/ONLYOFFICE/onlyoffice-chamilo/releases/download/vX.X.X/onlyoffice.zip

  Wobei vX.X.X die erforderliche Konnektorversion ist.

  unzip onlyoffice.zip

• Sie können auch den Konnektor holen:
  1. Holen Sie sich die neueste Version dieses Repositorys, indem Sie den Befehl ausführen:

     git clone https://github.com/ONLYOFFICE/onlyoffice-chamilo
     cd onlyoffice-chamilo

  2. Holen Sie sich ein Untermodul:

     git submodule update --init --recursive

  3. Sammeln Sie alle Dateien:

     mkdir /tmp/onlyoffice-deploy
     mkdir /tmp/onlyoffice-deploy/onlyoffice
     cp -r ./ /tmp/onlyoffice-deploy/onlyoffice
     cd /tmp/onlyoffice-deploy/onlyoffice
     rm -rf ./.git*
     rm -rf */.git*
                                      

Schritt 2: Entfernen Sie den alten Konnektor-Ordner:

1. Öffnen Sie das Terminal im Stammordner.
2. Entfernen Sie den Ordner mit dem folgenden Befehl:

   rm -rf /var/www/html/chamilo-x.x.x/plugin/onlyoffice

   Dabei ist chamilo-x.x.x Ihre Chamilo-Version.

Schritt 3: Verschieben Sie den neuen Konnektor-Ordner in das Verzeichnis chamilo-x.x.x/plugin/.

1. Öffnen Sie das Terminal im Stammordner.
2. Verschieben Sie den Ordner mit den folgenden Befehlen:

   cp -r /tmp/onlyoffice-deploy/onlyoffice /var/www/html/chamilo-x.x.x/plugin/

   Dabei ist chamilo-x.x.x Ihre Chamilo-Version.

Konfigurieren des ONLYOFFICE-Konnektors für Chamilo

Finden Sie ONLYOFFICE auf der Seite Plugins und klicken Sie auf Configure. Sie sehen die Seite Settings, auf der Sie die folgenden Parameter konfigurieren können:

• Geben Sie die Adresse, die für den Zugriff auf den Document Editing Service von Chamilo verwendet wird, in das Feld Document Editing Service address ein.
• Geben Sie im Feld Secret Key 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 Chamilo-Integration in diesem Artikel.

Aktivieren von JWT für die ONLYOFFICE- und Chamilo-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.

Deaktivieren des ONLYOFFICE-Konnektors für Chamilo

Wenn Sie den ONLYOFFICE-Konnektor deaktivieren müssen:

1. Finden Sie ONLYOFFICE auf der Seite Plugins und klicken Sie auf Configure.
2. Aktivieren Sie das Kontrollkästchen No im Abschnitt Enable.