SharePoint

Anforderungen

• ONLYOFFICE Document Server V. 7.1 (die Server- oder Cloud-Lösung) 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 (Alle Programme), zeigen Sie auf Administrative Tools (Verwaltungswerkzeuge), klicken Sie dann auf Services (Dienste) und stellen Sie sicher, dass die SharePoint Administration (SharePoint Verwaltung) gestartet ist.
2. Klicken Sie auf Start, klicken Sie auf SharePoint Management Shell (SharePoint-Verwaltungsshell) 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 (SharePoint-Zentralverwaltung) unter Application Management (App-Verwaltung) auf Manage web applications (Web-Apps verwalten).
6. Wählen Sie Ihre Webseite aus und klicken Sie auf das Symbol Authentication Providers (Authentifizierungsanbieter).
7. Klicken Sie im Pop-Up-Fenster Authentication Providers (Authentifizierungsanbieter) auf Default zone (Standardzone).
8. Aktivieren Sie unter Edit Authentication (Authentifizierung bearbeiten) die Option Enable anonymous access (Anonymen Zugriff aktivieren) und klicken Sie auf Save (Speichern).
9. Kehren Sie zum Web Application Management (Webanwendungsmanagement) zurück, klicken Sie auf das Symbol Anonymous Policy (Anonyme Richtlinie).
10. Wählen Sie unter Anonymous Access Restrictions (Anonyme Zugriffsbeschränkungen) Ihre Zone aus, setzen Sie die Permissions to None – No (Berechtigungen für Keine – Nein) und klicken Sie auf Save (Speichern).
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.

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 SharePoint-Seite aktivieren: Suchen Sie Ihren geheimen Schlüssel in der Konfigurationsdatei von ONLYOFFICE Docs und geben Sie dann denselben geheimen Schlüssel in den SharePoint-Verwaltungseinstellungen an. Weitere Einzelheiten finden Sie im Abschnitt JWT für die ONLYOFFICE- und SharePoint-Integration aktivieren dieses Artikels.

Wenn der JWT-Schutz aktiviert ist, muss ein benutzerdefinierter Header-Name angegeben werden, da die SharePoint-Sicherheitsrichtlinie externe „Autorisierungs“-Header blockiert. Dieser Header sollte auch in den Signatureinstellungen von ONLYOFFICE Docs angegeben werden (weitere Informationen finden Sie hier).

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

     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 Secret Key (Geheimer Schlüssel) an und speichern Sie die Einstellungen.