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 HumHub

ONLYOFFICE offre un connecteur officiel pour intégrer ONLYOFFICE Docs dans HumHub afin de modifier les documents de bureau au sein du réseau social. Vous pouvez télécharger le connecteur ONLYOFFICE à partir de Humhub Marketplace officiel ou de la page ONLYOFFICE sur GitHub.

Pour en savoir plus sur le fonctionnement du connecteur ONLYOFFICE pour HumHub, veuillez consulter notre documentation API.

Principales caractéristiques

  • Créer, modifier et afficher les documents texte, les feuilles de calcul et les présentations.
  • Modifier un document en collaboration en temps réel : deux modes de collaboration (Strict et Rapide), le mode de Suivi des modifications, commentaires et un chat intégré.
  • 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

  • À créer, modifier et afficher : DOCX, PPTX, XLSX
  • À convertir en Office Open XML : ODT, ODS, ODP, DOC, XLS, PPT, TXT, CSV
  • À afficher : PDF

Toutes les nouveautés de la version 2.2.2

Corrigé

  • Prise en charge de JWT

Le journal des modifications complet est disponible ici.

Connecter ONLYOFFICE Docs à HumHub

Exigences

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

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

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

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

  • HumHub 1.3 et version ultérieure
  • Connecteur ONLYOFFICE 2.2.2 pour HumHub

Installer le connecteur ONLYOFFICE pour HumHub

Vous pouvez télécharger la dernière version du connecteur à partir de Humhub Marketplace officiel et la configurer. Pour le faire, suivez ces étapes :

  • Connectez-vous à votre instance Humhub en tant qu'administrateur.
  • Cliquez sur la liste déroulante du profil et sélectionnez l'option Administration. L'écran Gestion des utilisateurs s'affiche.
  • Cliquez sur la section Modules sur le panneau gauche.
  • Entrez à la section Naviguer en ligne et utilisez la fonction de recherche pour trouver Connecteur ONLYOFFICE. Les résultats de la recherche incluent les versions qui sont compatibles avec votre instance Humhub.
  • Cliquez sur le bouton Installer pour télécharger et installer le module ONLYOFFICE.
  • Une fois le module installé, cliquez sur le bouton Activer.
    ONLYOFFICE_install ONLYOFFICE_install

Configurer le connecteur ONLYOFFICE pour HumHub

  1. Passez à Administration -> Modules -> Installés.
  2. Recherchez le module Connecteur ONLYOFFICE pour HumHub.
  3. Cliquez sur le bouton Configurer.
  4. Configurez les paramètres suivants :
    • Nom de l'hôte - indiquez l'adresse URL du Service de modification de documents (par défaut ONLYOFFICE Docs utilise le port 80).
      ImportantL'adresse de ONLYOFFICE Docs doit être accessible depuis HumHub, ainsi que l'adresse de HumHub doit être accessible depuis ONLYOFFICE Docs.
    • JWT secret - indiquez la clé secrète 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 HumHub : 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 du connecteur. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer de ONLYOFFICE et HumHub.
  5. Adresse de ONLYOFFICE Docs pour les demandes internes du serveur - indiquez l'adresse utilisée pour accéder au Service de modification de documents à partir de HumHub.
  6. Adresse du serveur pour les demandes internes de ONLYOFFICE Docs - indiquez l'adresse utilisée pour accéder à HumHub à partir du Service de modification de documents.
Configure_menu Configure_menu

Une fois l'application d'intégration configurée, cliquez sur le bouton Soumettre pour enregistrer les modifications.

Activer le jeton JWT pour intégrer ONLYOFFICE et HumHub

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.

Commencer à utiliser ONLYOFFICE Docs au sein de HumHub

À créer un document :

  1. Rendez-vous sur l'onglet Fichiers.
  2. Cliquez sur le bouton Ajouter fichier(s).
  3. Sélectionnez l'option Créer document.
    ONLYOFFICE_create1 ONLYOFFICE_create1
  4. Dans la fenêtre qui s'affiche sélectionnez le type de fichier : Document, Feuille de calcul ou Présentation.
    ONLYOFFICE_create2 ONLYOFFICE_create2
  5. Indiquez le nom du fichier.
  6. Sélectionnez l'option Ouvrir le nouveau document à l'étape suivante afin de commencer à travailler avec le document.
  7. Cliquez sur le bouton Enregistrer.
    ONLYOFFICE_create3 ONLYOFFICE_create3

À afficher/modifier un document :

  1. Rendez-vous sur l'onglet Fichiers.
  2. Cliquez sur le fichier nécessaire.
  3. Dans la fenêtre qui s'affiche cliquez sur le bouton Modifier le document.
    ONLYOFFICE_editview ONLYOFFICE_editview
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