Exigences

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

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

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

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

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

Installer le connecteur ONLYOFFICE pour Mattermost

Configurer le connecteur ONLYOFFICE pour Mattermost

Passez à System Console (Console du système) -> recherchez le module complémentaire ONLYOFFICE en utilisant la recherche -> Configure (Configurer). Activez le module complémentaire dans le champ approprié et configurez les paramètres suivants:

1. Document Editing Service address (Adresse du service de modification des documents) - saisissez l'adresse URL où ONLYOFFICE Docs est installé (par ex. https://documentserver).
   ImportantL'adresse d'ONLYOFFICE Docs doit être accessible sur Mattermost et l'adresse de Mattermost doit être accessible sur ONLYOFFICE Docs.
2. Secret key (Clé secrète) - la clé secrète JWT utilisée pour signer les données.
   À 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é Mattermost: recherchez 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. Pour en savoir plus, consultez la section Activer le jeton JWT pour l'intégration ONLYOFFICE et Mattermost.
3. JWT Header (En-tête JWT) - indiquez l'en-tête JWT.
   ImportantLorsque 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 Mattermost. Les paramètres de l'en-tête doivent être également fourni dans la signature ONLYOFFICE Docs (pour plus d'informations, cliquez ici).
4. JWT Prefix (Suffixe JWT) - indiquez le suffixe JWT.

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

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.

Créer et modifier des fichiers

Afficher l'historique de modifications

Une notification de tout modification sera envoyé avec le nom de l'utilisateur.

Toutes les notifications sont disponibles dans un fil de modifications. Pour ouvrir le fil de modifications, cliquez sur la flèche à droite du fichier.