Exigences

• ONLYOFFICE Document Server v7.1 ou version ultérieure
  Vous avez besoin d'activer WOPI en suivant cette instruction.

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

  Veuillez consulter la documentation officielle pour en savoir plus sur l'installation de 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 à la page GitHub sous la Licence GNU AGPL v.3.

1. Cliquez sur Démarrer, passez à Tous les programmes, passez à Outils administratifs, ensuite cliquez sur Services et assurez-vous que le service Administration de SharePoint est démarré.
2. Cliquez sur Démarrer, puis sur SharePoint Management Shell et passez au répertoire contenant le fichier .wsp.
3. Exécuter le script Install.ps1 :

   PS> .\Install.ps1

4. Entrez votre adresse du site SharePoint :

   https://

   Au lieu de suivre les étapes 3 et 4 vous pouvez taper la commande suivante :

   Add-SPSolution -LiteralPath/onlyoffice.wsp

   À la page d'accueil Administration centrale de SharePoint cliquez sur Paramètres du système > Gestion de la batterie > Gérer les solutions de la batterie. À la page Gestion des solutions cliquez sur onlyoffice.wsp, puis sur Déployer la solution.

5. À la page d'accueil Administration centrale de SharePoint cliquez sur Gérer les applications web sous Gestion des applications.
6. Assurez-vous de sélectionner votre site et cliquez sur l'icône Fournisseurs d'authentification.
7. Cliquez sur Zone par défaut dans la fenêtre indépendante Fournisseurs d'authentification.
8. Cochez Activer l'accès anonyme sous Modifier l'authentification, ensuite cliquez sur Enregistrer.
9. En revenant à Gérer les applications web cliquez sur l'icône Stratégie anonyme.
10. Sous Restrictions d'accès anonyme sélectionnez votre Zone et saisissez la Stratégie d'autorisation – Aucune, ensuite cliquez sur Enregistrer.
11. Dans SharePoint, ouvrez la page de paramètres administratifs /_layouts/15/Onlyoffice/Settings.aspx. Entrez l'adresse suivante :

    https://<documentserver>/

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

À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous devez également l'activer du côté de SharePoint : trouvez votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite spécifiez la même clé secrète aux paramètres d'administration de SharePoint. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer ONLYOFFICE et SharePoint.

Si la protection JWT est activée, il est nécessaire de spécifier un nom d'en-tête personnalisé puisque la politique de sécurité de SharePoint bloque les en-têtes « Autorisation » externes. Cet en-tête doit également être spécifié dans les paramètres de signature de ONLYOFFICE Docs (les instructions plus détaillées sont disponibles ici).

Activer le jeton JWT pour intégrer ONLYOFFICE et SharePoint

Afin de protéger les documents de tout accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON Web Token (JWT). Le jeton est ajouté à la configuration lors de l'initialisation de l'Éditeur de Documents et lors de l'échange de commandes entre les services internes de ONLYOFFICE Docs. La clé secrète est utilisée pour signer le jeton JSON et valider le jeton sur la demande à la connexion de ONLYOFFICE Docs.

À partir de la version ONLYOFFICE Docs v7.2 le jeton JWT est activé par défaut et la clé secrète est générée automatiquement. Vous avez besoin de trouver votre propre clé secrète dans le fichier de configuration ONLYOFFICE Docs et ensuite de spécifier la même clé secrète aux paramètres du connecteur.

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

1. Ouvrez le fichier local.json à l'aide d'un éditeur de texte disponible.
   • Pour Linux - /etc/onlyoffice/documentserver/local.json
   • Pour Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Pour Docker - entrez le conteneur ONLYOFFICE Docs en utilisant la commande docker exec -it <containerID> bash et ouvrez-le. /etc/onlyoffice/documentserver/local.json

     À titre subsidiaire, vous pouvez utiliser la commande suivante pour trouver la clé secrète par défaut sans ouvrir 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. La valeur true est spécifiée 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 générée automatiquement est spécifiée dans trois sections. Vous pouvez remplacer la valeur secrète par défaut avec votre propre clé secrète. La clé secrète doit être identique dans trois sections.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Si vous apportez des modifications, enregistrez-les et redémarrez les services pour que les modifications de configuration prennent effet.

   supervisorctl restart all

Étape 2 : Spécifier la même clé secrète aux paramètres du connecteur

Spécifiez la même clé secrète aux paramètres du connecteur dans le champ Clé secrète et enregistrez les paramètres.