Articles avec le tag :
Fermer
Changelog
Fermer
Essayer dans le cloud
Essayer dans le cloud
Centre d'aide
l'intégration

À propos de l'intégration de ONLYOFFICE et Mattermost

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans Mattermost afin de collaborer sur les documents de bureau envoyés aux chats privés ou de groupe. Il peut être téléchargé à partir de GitHub. L'application est rendue 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 les documents texte, les feuilles de calcul et les présentations en utilisant l'option Ouvrir le fichier dans ONLYOFFICE.
  • Gérer des droits d'accès (Modifier ou Lire) depuis le menu contextuel avec l'option Modifier les droits d'accès.
  • Afficher l'historique des modifications du fichier.
  • 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
  • À afficher : 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

Quoi de neuf dans la version 1.1.1

Modifié

  • Travail avec s3 bucket corrigé
  • Chargeur d'éditeur corrigé
  • Dépendances mises à jour

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à Mattermost

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

Afin de connecter Mattermost, veuillez suivre ces étapes :

  1. Obtenez l'application d'intégration Mattermost ONLYOFFICE. Il y a quelques moyens de le faire :
    • Téléchargez la version la plus récente à partir de la page de versions de l'application sur GitHub.
    • Clonez le code source de l'application et compilez-le vous-même :
      1. Clonez la branche maîtresse.
      2. Passez à la racine du projet.
      3. Installez les dépendances :
        npm install --legacy-peer-deps
        Pour configurer le plug-in, il faut installer le Node.js v.15.14.0 sur votre machine.
      4. Exécutez la commande suivante :
        make dist
  2. Allez à (your_mattermost_host)/admin_console/plugins/plugin_management
  3. Choisissez le fichier tar.gz téléchargé ou le plug-in compilé dans votre dossier dist et appuyez sur Télécharger.

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).
  2. ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis Mattermost ainsi que l'adresse de Mattermost doit être accessible depuis ONLYOFFICE Docs.
  3. Clé secrète - la clé secrète JWT du serveur de documents utilisée pour signer les données.
  4. À 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.
  5. En-tête JWT - spécifiez l'en-tête JWT.
  6. 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).
  7. Préfixe JWT - spécifiez le préfixe JWT.
ONLYOFFICE_configuration ONLYOFFICE_configuration

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.

Pour bien commencer

Afficher et modifier des fichiers

  • Cliquez sur le bouton Plus d'actions More Actions button à côté du fichier envoyé dans un chat Mattermost.
  • Choisissez l'option Ouvrir le fichier dans ONLYOFFICE au menu contextuel.
    ONLYOFFICE_filemenu ONLYOFFICE_filemenu

ou

  • Cliquez sur le nom du fichier.
  • La fenêtre d'aperçu du fichier s'affiche. Afin de partager le fichier avec d'autres utilisateurs, cliquez sur le bouton Partager. Afin de commencer à modifier, cliquez sur le bouton Modifier dans ONLYOFFICE.
    ONLYOFFICE_previewfile ONLYOFFICE_previewfile

Le fichier sera ouvert dans l'éditeur ONLYOFFICE approprié.

Modifier les droits d'accès

Par défaut l'expéditeur a les droits d'accès modification tandis que le destinataire possède des droits d'accès lecture. Afin de modifier les paramètres, utilisez l'option Modifier les droits d'accès disponible dans le menu contextuel du fichier. Cette option n'est disponible qu'à l'expéditeur.

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

Dans un chat privé :

  • Utilisez le menu déroulant dans le champ Droits d'accès pour @utilisateur.
    ONLYOFFICE_privatechat ONLYOFFICE_privatechat

Dans un chat de groupe pour tous les participants :

  • Utilisez le menu déroulant dans le champ Droits d'accès par défaut pour les participants du chat.
    ONLYOFFICE_groupchatall ONLYOFFICE_groupchatall

Dans un chat de groupe pour certains participants :

  • Utilisez le menu déroulant en haut, choisissez l'utilisateur nécessaire et cliquez sur le bouton Ajouter à droite.

    ONLYOFFICE_groupchatcertain ONLYOFFICE_groupchatcertain

  • Cet utilisateur apparaîtra dans la liste au-dessous. Changez ses droits d'accès à l'aide du menu déroulant à droite.
    ONLYOFFICE_groupchatcertain ONLYOFFICE_groupchatcertain
Le gestionnaire de droits d'accès enverra une notification du robot à la partie correspondante.

Afficher l'historique des modifications

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

ONLYOFFICE_versionhistory ONLYOFFICE_versionhistory

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

ONLYOFFICE_versionhistory ONLYOFFICE_versionhistory
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
Cela peut vous aider aussi :
Fermer