Mattermost

À propos de l'intégration ONLYOFFICE et Mattermost

ONLYOFFICE propose un connecteur officiel pour intégrer ONLYOFFICE Docs dans Mattermost pour collaborer sur des documents joints aux messages privés ou de groupe. Le connecteur est disponible en téléchargement sur le site officiel ou sur GitHub. L'application est rendu accessible sous la Licence Apache.

Pour en savoir plus sur le fonctionnement et la compilation du connecteur ONLYOFFICE pour Mattermost, veuillez consulter notre documentation API .

Principales caractéristiques

Afficher et modifier des documents texte, des feuilles de calcul et des présentations et à l'aide de l'option Open file in ONLYOFFICE (Ouvrir le fichier dans ONLYOFFICE).
Gérer des droits d'accès Edit (Modifier) ou Read (Lecture)) dans le menu contextuel de l'option Change access rights (Modifier les droits d'accès).
Collaborer sur des documents en temps réel: deux modes de co-édition (Strict et Rapide).
Afficher l'historique des modifications.
Prise en charge de JWT pour l'échange sécurisé afin que personne ne puisse accéder à vos documents sauf celles ayant les privilèges d'accès appropriés.

Formats pris en charge

À modifier et afficher: DOCX, PPTX, XLSX
En lecture seule: XLS, XLSX, CSV, XLSM, XLT, XLTM, ODS, FODS, OTS, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP, DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF

Toutes les nouveautés de la version 1.1.3

Nouvelles fonctionnalités ajoutées

Le lien est ajouté à Docs Cloud

Fonctionnalités modifiées

Les dépendances vulnérables sont mises à jour

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Mattermost

Exigences

ONLYOFFICE Document Server v6.4.0 (version serveur ou cloud) 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.
Il est possible d'installer ONLYOFFICE Docs et Mattermost sur des ordinateurs différents ou sur la même machine. Si vous utilisez un seul ordinateur, configurez un port personnalisé pour le serveur de documents.
Mattermost v. 5.37.2 ou version ultérieure
Connecteur ONLYOFFICE v1.1.3 pour Mattermost

Installer le connecteur ONLYOFFICE pour Mattermost

Pour connecter Mattermost, procédez comme suit:

Recherchez l'application d'intégration ONLYOFFICE pour Mattermost. Il y a plusieurs façons de ce faire:
- Téléchargez la version la plus récente sur la page de nouvelles versions de l'application sur GitHub.
- Clonez le code source de l'application et compilez le code vous-même:
  1. Clonez le branche master.
  2. Passez à la racine du projet.
  3. Installez les dépendances:
```
npm install --legacy-peer-deps
```
    Pour créer un module complémentaire, il vous faut installer Node.js v.15.14.0 sur votre ordinateur.
  4. Exécutez la commande suivante:
```
make dist
```
Passez à (your_mattermost_host)/admin_console/plugins/plugin_management
Recherchez le fichier tar.gz que vous avez téléchargé ou le module complémentaire compilé du dossier dist et appuyez sur Upload (Télécharger).

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:

Document Editing Service address (Adresse du service d'édition des documents) - saisissez l'adresse URL osur laquelle ONLYOFFICE Docs est installé (par ex. https://documentserver).
L'adresse d'ONLYOFFICE Docs doit être accessible sur Mattermost et l'adresse de Mattermost doit être accessible sur ONLYOFFICE Docs.
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.
JWT Header (En-tête JWT) - indiquez l'en-tête JWT.
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 Mattermost. Les paramètres de l'en-tête doivent être également fourni dans la signature ONLYOFFICE Docs (pour plus d'informations, cliquez ici).
JWT Prefix (Suffixe JWT) - indiquez le suffixe JWT.

Comment cela fonctionne

L'interaction utilisateur-document se produit à la fois du côté client et du côté serveur.

Les concepts clés mentionnés dans notre documentation sont les suivantes:

Le côté client inclut:

Gestionnaire de documents (Document manager) - la liste des documents qui s'affiche dans le navigateur d'utilisateur dans laquelle l'utilisateur peut sélectionner le document nécessaire et manipuler les documents (en fonction d'autorisations attribuées, l'utilisateur peut ouvrir le document en lecture seule ou en écriture, partager des documents avec d'autres utilisateurs).
Éditeur de documents (Document editor) - l'interface permettant d'afficher et modifier des documents dotée de fonctionnalités d'édition les plus utilisées, est un moyen par lequel un utilisateur interagit avec le service d'édition de documents.

Le côté serveur inclut:

Service de stockage de documents (Document storage service) - le service du serveur pour stocker tous les documents disponibles aux utilisateurs dotés des autorisations d'accès appropriées. Ce service fournit les identifiants de documents et les liens vers ces documents au gestionnaire de documents que l'utilisateur voit dans son navigateur.
Service d'édition de documents (Document editing service) - le service du serveur permettant d'afficher et de modifier les documents (lorsque l'utilisateur est doté des autorisations d'accès appropriées). L'interface de l'éditeur de documents sert à accéder à toutes les fonctionnalités du service d'édition de documents.
Service de gestion de commandes dans le document (Document command service) - le service du server permettant d'effectuer les commandes supplémentaires à l'aide du service d'édition des documents. editing service.
Service de conversion des documents (Document conversion service) - le service du serveur permettant de convertir le document au format Office Open XML approprié (docx pour les documents texte, xlsx pour les feuilles de calcul et pptx pour les présentations) à des fins d'édition ou téléchargement.
Service de génération des documents (Document builder service) - le service du serveur permettant de générer facilement un document sans lancer une application de traitement des documents.

Veuillez noter que le serveur de documents ONLYOFFICE comprend l'éditeur de documents, le service d'édition des documents, le service de gestion de commandes dans le document, le service de conversion des documents et le service de génération des documents. Le gestionnaire des documents et le service de stockage des documents sont inclus dans le Serveur Communauté ou doivent être implémentés par les intégrateurs de logiciels qui utilisent le serveur de documents ONLYOFFICE sur propre serveur.

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

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"}}}}}
```
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
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
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.

Commencer à utiliser ONLYOFFICE Docs au sein de Mattermost

Créer et modifier des fichiers

Cliquez sur le bouton More Actions (Plus d'actions) à côté du fichier envoyé dans un message Mattermost.
Sélectionnez l'option Open file in ONLYOFFICE (Ouvrir le fichier dans ONLYOFFICE) dans le menu contextuel.

Cliquez sur le nom du fichier.
La fenêtre d'aperçu du fichier apparaîtra. Pour partager un fichier avec d'autres utilisateurs, cliquez sur le bouton Share (Partager). Pour procéder à l'édition, cliquez sur le bouton Edit in ONLYOFFICE (Modifier dans ONLYOFFICE).

Le fichier sera ouvert avec l'éditeur ONLYOFFICE Docs.

Gérer des droits d'accès

Par défaut, l'expéditeur est accordé la permission de modification et le destinataire est accordé la permission de lecture. Pour modifier les permissions d'accès, utilisez l'option Change access rights (Modifier les droits d'accès) dans le menu contextuel du fichier. Cette option est disponible uniquement pour l'expéditeur.

Pour collaborer sur un document, les utilisateurs autorisés doivent ouvrir le même fichier à la fois.

Messages privés:

Utilisez la liste déroulante dans le champ Access rights for @user (Droits d'accès pour @utilisateur).

Message pour tous les membres du groupe:

Utilisez la liste déroulante dans le champ Default access rights for chat members (Droits d'accès pour les membres de la discussion par défaut).

Message pour un certain utilisateur du groupe:

Utilisez la liste déroulante en haut, sélectionnez l'utilisateur nécessaire et cliquez sur le bouton Add (Ajouter) à droite.
L'utilisateur apparaîtra dans la liste en dessous. Modifiez les permissions d'accès à l'aide de la liste déroulante à droite.

Lors de la gestion des droits d'accès, une notification sera envoyé par l'agent conversationnel à l'utilisateur sélectionné.

Afficher l'historique des 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.

Hébergez ONLYOFFICE Docs sur votre serveur ou utilisez dans le cloud

Obtenir maintenant Utiliser dans le cloud