Anforderungen

• ONLYOFFICE Document Server v7.1 oder höher
  Sie müssen WOPI nach dieser Anleitung aktivieren.

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

  Weitere Informationen über die Installation von ONLYOFFICE Docs finden Sie auf der offiziellen Dokumentationsseite.
• SharePoint 2019
• ONLYOFFICE Konnektor 3.0.0 für SharePoint

ONLYOFFICE und SharePoint installieren und konfigurieren

Die ONLYOFFICE SharePoint-Integrationslösung ist ein offizieller ONLYOFFICE-Konnektor, der auf der GitHub-Seite unter der GNU AGPL v.3-Lizenz verfügbar ist.

1. Klicken Sie auf Start, zeigen Sie auf All Programs, zeigen Sie auf Administrative Tools, klicken Sie dann auf Services und stellen Sie sicher, dass die SharePoint Administration gestartet ist.
2. Klicken Sie auf Start, klicken Sie auf SharePoint Management Shell und wechseln Sie zum Verzeichnis mit der .wsp-Datei.
3. Führen Sie das Skript Install.ps1 aus:

   PS> .\Install.ps1

4. Geben Sie Ihre SharePoint-Site-Adresse ein:

   https://<yoursharepointsite>

   Anstelle der Schritte 3 und 4 können Sie den folgenden Befehl eingeben:

   Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp

   Klicken Sie auf der Startseite SharePoint Central Administration auf System Settings > Farm Management > Manage farm solutions. Klicken Sie auf der Seite Solution Management auf onlyoffice.wsp und dann auf Deploy Solution.

5. Klicken Sie auf der Startseite SharePoint Central Administration unter Application Management auf Manage web applications.
6. Wählen Sie Ihre Webseite aus und klicken Sie auf das Symbol Authentication Providers.
7. Klicken Sie im Pop-Up-Fenster Authentication Providers auf Default zone.
8. Aktivieren Sie unter Edit Authentication die Option Enable anonymous access und klicken Sie auf Save.
9. Kehren Sie zum Web Application Management zurück, klicken Sie auf das Symbol Anonymous Policy.
10. Wählen Sie unter Anonymous Access Restrictions Ihre Zone aus, setzen Sie die Permissions to None – No und klicken Sie auf Save.
11. Öffnen Sie in SharePoint die Seite /_layouts/15/Onlyoffice/Settings.aspx mit administrativen Einstellungen. Geben Sie die folgende Adresse ein:

    https://<documentserver>/

    Wobei documentserver der Name des Servers ist, auf dem ONLYOFFICE Docs installiert ist. Die Adresse muss für den Benutzerbrowser und vom SharePoint-Server zugänglich sein. Auf die SharePoint-Serveradresse muss auch von ONLYOFFICE Docs aus zugegriffen werden können, damit sie ordnungsgemäß funktioniert.

JWT für die ONLYOFFICE- und SharePoint-Integration aktivieren

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.