Exigences

• ONLYOFFICE Docs (Document Server) 6.4.0 ou version ultérieure

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

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

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

• Mattermost v. 5.37.2 ou version ultérieure
• ONLYOFFICE Connector v1.1.1 pour Mattermost

Installer le connecteur ONLYOFFICE pour Mattermost

Configurer le connecteur ONLYOFFICE pour Mattermost

Passez à la Console système -> trouvez le plug-in ONLYOFFICE via recherche -> Configurer. Activez le plug-in dans le champ approprié et spécifiez les paramètres suivants :

1. Service de modification de documents - indiquez l'adresse URL de ONLYOFFICE Docs (par exemple, https://documentserver).
ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis Mattermost ainsi que l'adresse de Mattermost doit être accessible depuis ONLYOFFICE Docs.
2. Clé secrète - la clé secrète JWT du serveur de documents utilisée pour signer les données.
À 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 Mattermost : trouvez votre propre clé secrète dans le fichier de configuration de ONLYOFFICE Docs et ensuite spécifiez la même clé secrète aux paramètres du connecteur. Pour en savoir plus, consultez la section de l'article Activer le JWT pour intégrer ONLYOFFICE et Mattermost.
3. En-tête JWT - spécifiez l'en-tête JWT.
ImportantSi 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 Mattermost bloque les en-têtes externes d''Autorisation'. Cet en-tête doit également être spécifié dans les paramètres de signature de ONLYOFFICE Docs (pour en savoir plus, veuillez consulter cet article).
4. Préfixe JWT - spécifiez le préfixe JWT.

Activer le JWT pour intégrer ONLYOFFICE et Mattermost

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écifiez 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.

Afficher et modifier des fichiers

Afficher l'historique des modifications

Toutes les modifications apportées au fichier seront envoyées sous forme de notifications contenant le nom d'utilisateur.

Les notifications sont disponibles dans la discussion dédiée. Afin d'ouvrir la discussion, cliquez sur la flèche à droite du fichier.