Alfresco

Anforderungen

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

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

  Weitere Informationen finden Sie auf der offiziellen Dokumentationsseite über die Installation von ONLYOFFICE Docs.
• Alfresco V. 6.2 - 7.2
• ONLYOFFICE Konnektor 6.0.0 für Alfresco

ONLYOFFICE und Alfresco Modulpaket installieren

Die neuesten kompilierten Paketdateien sind auf GitHub verfügbar. Sie benötigen die Dateien onlyoffice-integration-repo.jar und onlyoffice-integration-share.jar. Wenn Sie aus irgendeinem Grund vorhaben, das ONLYOFFICE- und Alfresco-Modulpaket selbst zu kompilieren (z. B. den Quellcode bearbeiten und dann kompilieren), lesen Sie bitte die Entwickleranleitung.

1. Laden Sie kompilierte Pakete in die Verzeichnisse repo und share herunter:

   cd onlyoffice-alfresco/
   mvn clean install

2. Laden Sie die kompilierten *.jar-Pakete in entsprechende Verzeichnisse für Ihre Alfresco-Installation hoch:
   • von onlyoffice-alfresco/repo/target/ zum /webapps/alfresco/WEB-INF/lib/ für das Alfresco-Repository.
   • von onlyoffice-alfresco/share/target/ zum /webapps/share/WEB-INF/lib/ für Share.

3. (Optional) Bearbeiten Sie die Datei alfresco-global.properties, um die richtigen Hostnamen, offenen Ports und Protokolle anzugeben, da Alfresco und Share als zwei separate Dienste bereitgestellt werden:

   alfresco.host=<hostname>
   alfresco.port=443
   alfresco.protocol=https
   
   share.host=<hostname>
   share.port=443
   share.protocol=https

4. Starten Sie Alfresco neu:

   sudo ./alfresco.sh stop
   sudo ./alfresco.sh start

5. Prüfen Sie, ob das Modul in der Liste unter /share/page/console/admin-console/module-package vorhanden ist.

ONLYOFFICE und Alfresco Modulpaket konfigurieren

Gehen Sie zu Alfresco-Verwaltungskonsole. Öffnen Sie http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config und geben Sie die folgenden Parameter an.

Document Server Einstellungen:

• Document Editing Service address (Adresse des Dokumentbearbeitungsdienstes): Geben Sie die URL-Adresse an, unter der Document Editing Service installiert ist.
  Wichtig Die Adresse von ONLYOFFICE Docs muss von Alfresco aus zugänglich sein, und die Adresse von Alfresco muss von ONLYOFFICE Docs aus zugänglich sein.
• Secret Key (Geheimer Schlüssel): Geben Sie das Geheimnis an, das 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 Alfresco-Seite aktivieren: Suchen Sie Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs und geben Sie dann denselben geheimen Schlüssel in den Connector-Einstellungen an. Weitere Einzelheiten finden Sie im Abschnitt Aktivieren von JWT für die Integration von ONLYOFFICE und Alfresco dieses Artikels.

Erweiterte Servereinstellungen:

• Document Editing Service address for internal requests from the Alfresco server (Adresse des Dokumentbearbeitungsdienstes für interne Anfragen vom Alfresco-Server): Geben Sie die Adresse an, die für den Zugriff auf Document Editing Service vom Alfresco-Server verwendet wird.
• Alfresco server address for internal requests from the Document Editing Service (Alfresco-Serveradresse für interne Anfragen vom Dokumentenbearbeitungsdienst): Geben Sie die Adresse an, die für den Zugriff auf den Alfresco-Server vom Document Editing Service verwendet wird.

Allgemeine Einstellungen:

• Ignore SSL Certificate (SSL-Zertifikat ignorieren): SSL wird deaktiviert.
• Enable Force Save (Force-Save aktivieren): Ermöglicht das Speichern von Dokumentänderungen direkt im Alfresco-Speicher, nachdem Sie auf die Schaltfläche Save (Speichern) geklickt haben (wenn diese Option deaktiviert ist, wird das Dokument im Cache des Dokumenteneditors gespeichert, bis das Dokument geschlossen wird).
• Save docx, xlsx, pptx as a new version of the original file after conversion (docx, xlsx, pptx nach der Konvertierung als neue Version der Originaldatei speichern): Wenn deaktiviert, wird eine separate Datei erstellt und im selben Ordner abgelegt.
• Open the file for editing (Datei zum Bearbeiten öffnen): Ermöglicht Administratoren die Auswahl der zu bearbeitenden Dokumentformate durch Konvertierung in OOXML-Formate.

Aktivieren von JWT für die Integration von ONLYOFFICE und Alfresco

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

Ab ONLYOFFICE Docs v7.2 ist JWT standardmäßig aktiviert und der geheime Schlüssel wird automatisch generiert. Sie müssen Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs finden 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: In den Konnektor-Einstellungen denselben geheimen Schlüssel angeben

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

Verbinden mit der Demo ONLYOFFICE Docs

Ab ONLYOFFICE-Konnektor Version 5.0.0 können Sie ONLYOFFICE Online-Editoren in Alfresco testen, ohne ONLYOFFICE Docs installieren zu müssen.

Um die Verbindung einzuschalten, klicken Sie auf das Kontrollkästchen Connect to demo ONLYOFFICE Document Server (Verbindung zur Demoversion von ONLYOFFICE Document Server herstellen) und klicken Sie auf die Schaltfläche Save (Speichern).