Exigences

• ONLYOFFICE Document Server v7.1 ou version ultérieure.
  Il vous faut activer WOPI en suivant cette instruction.

  Vous avez besoin d'une instance ONLYOFFICE Docs pouvant être résolue et connectée par SharePoint et tout autre client final. L'instance doit envoyer des données en POST directement vers SharePoint.

  Veuillez consulter la documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.

  Vous pouvez également utiliser ONLYOFFICE Docs Cloud (version SaaS).

• SharePoint 2019
• Connecteur ONLYOFFICE 3.0.0 pour SharePoint

Installer et configurer ONLYOFFICE et SharePoint

La solution d'intégration ONLYOFFICE SharePoint est un connecteur officiel ONLYOFFICE disponible sur la page GitHub sous la Licence GNU AGPL v.3.

1. Cliquez sur Démarrer, passez à All Programs (Tous les programmes), passez à Administrative Tools (Outils administratifs), ensuite cliquez sur Services et vérifiez si le service Administration de SharePoint est démarré.
2. Cliquez sur Start (Démarrer), ensuite sur SharePoint Management Shell (Shell de gestion SharePoint) et passez au référentiel contenant le fichier .wsp.
3. Exécutez le script Install.ps1 script:

   PS> .\Install.ps1

4. Saisissez l'adresse de votre site SharePoint:

   https://<yoursharepointsite>

   Pour sauter les étapes 3 et 4, saisissez la commande suivante:

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

   Sur la page d'accueil SharePoint Central Administration (Administration centrale de SharePoint), cliquez sur System Settings > Farm Management > Manage farm solutions. (Paramètres de système > Gestion de batterie > Solutions de gestion de la batterie). Sur la page Solution Management (Gestion de la solution), cliquez sur onlyoffice.wsp, ensuite cliquez sur Deploy Solution (Déployer la solution).

5. Sur la page d'accueil SharePoint Central Administration (Administration centrale de SharePoint), cliquez sur Application Management (Gérer les applications) au-dessous de Manage web applications (Gestion des applications).
6. Assurez-vous que vous sélectionnez votre site et cliquez sur l'icône Authentication Providers (Fournisseurs d'authentification).
7. Dans la fenêtre Authentication Providers (Fournisseurs d'authentification), cliquez sur Default zone (Zone par défaut).
8. Au-dessous de l'option Edit Authentication (Modifier l'authentification), activez Enable anonymous access (Activer l'accès anonyme) et cliquez sur Save (Enregistrer).
9. Revenez à Web Application Management (Gérer les applications web) et cliquez sur l'icône Anonymous Policy (Stratégie anonyme).
10. Au-dessous de Anonymous Access Restrictions (Restrictions d'accès anonyme) sélectionnez votre Zone et saisissez la Permissions to None – No policy (Aucune permission - Pas de stratégie) et cliquez sur Save (Enregistrer).
11. Dans SharePoint, ouvrez la page comportant les paramètres d'administration /_layouts/15/Onlyoffice/Settings.aspx. Saisissez l'adresse suivante:

    https://<documentserver>/

    Où documentserver est le nom du serveur sur lequel ONLYOFFICE Docs est installé. L'adresse doit être accessible au navigateur de l'utilisateur et à partir du serveur SharePoint. L'adresse du serveur SharePoint doit également être accessible depuis ONLYOFFICE Docs pour un bon fonctionnement.

À partir de la version de ONLYOFFICE Docs v.7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut également activer la validation du jeton du côté SharePoint: recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète sur la page comportant les paramètres d'administration de SharePoint. Pour en savoir plus, consultez la section Activer le jeton JWT pour l'intégration ONLYOFFICE et SharePoint .

Lorsque la protection du JWT est activé, il faut indiquer l'en-tête personnalisé puisque les en-têtes externes d'autorisation sont bloqués par SharePoint. Les paramètres de l'en-tête doivent être également fourni dans la signature ONLYOFFICE Docs (pour plus d'informations, cliquez ici).

Activer le jeton JWT pour l'intégration ONLYOFFICE et SharePoint

Afin de protéger des documents contre un accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON (JWT). Le jeton est ajouté à la configuration lorsque l'éditeur de documents est initialisé et l'échange de commandes entre les services internes de ONLYOFFICE Docs est effectué. La clé secrète est utilisée pour signer le jeton web JSON et valider le jeton sur demande à ONLYOFFICE Docs.

À partir de la version de ONLYOFFICE Docs v.7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut rechercher votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète dans les paramètres du connecteur.

Étape 1: Recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs

1. Ouvrez le fichier local.json avec tout éditeur de texte disponible.
   • Pour Linux - /etc/onlyoffice/documentserver/local.json
   • Pour Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Pour Docker – indiquez le conteneur ONLYOFFICE Docs en utilisant la commande docker exec -it <containerID> bash et ouvrez /etc/onlyoffice/documentserver/local.json

     Vous pouvez également utiliser la commande suivante pour rechercher la clé secrète par défaut et sans ouvrir le fichier local .json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   Le fichier local .json doit ressembler à ceci:

   {
     "services": {
       "CoAuthoring": {
         "token": {
           "enable": {
             "request": {
               "inbox": true,
               "outbox": true
             },
             "browser": true
           }
         },
         "secret": {
           "inbox": {
             "string": "yoursecret"
           },
           "outbox": {
             "string": "yoursecret"
           },
           "session": {
             "string": "yoursecret"
           }
         }
       }
     }
   }
   

2. Le paramètre true figure dans trois sections. Cela signifie que la validation du jeton est activée.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. La clé secrète qui a été généré automatiquement figure dans trois sections. Vous pouvez remplacer le secret par défaut par votre propre clé secrète. La clé secrète doit être la même dans toutes trois sections.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Lorsque vous apportez des modifications, il vous faut les enregistrer et redémarrer les services pour prendre en compte ces modifications.

   supervisorctl restart all

Étape 2: Indiquez la même clé secrète dans la configuration du connecteur.

Dans la configuration du connecteur, indiquez la même clé secrète dans le champ Secret key (Clé secrète) et enregistrez les paramètres.