Exigences

• ONLYOFFICE Document Server v7.1 ou version ultérieure

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

  Veuillez consulter la documentation officielle pour en savoir plus sur l'installation de ONLYOFFICE Docs.
• Alfresco v.5.2 - 7.2
• Connecteur ONLYOFFICE 6.0.0 pour Alfresco

Installer ONLYOFFICE et le paquet de modules Alfresco

Les derniers fichiers package compilés sont accessibles à GitHub. Vous avez besoin des fichiers onlyoffice-integration-repo.jar et onlyoffice-integration-share.jar. Lorsque vous envisagez de compiler ONLYOFFICE et le paquet de modules Alfresco pour quelque raison que ce soit (par ex. pour modifier le code source et le compiler plus tard) veuillez consulter l'instruction de développeur.

1. Téléchargez les paquets compilés aux répertoires repo et share :

   cd onlyoffice-alfresco/
   mvn clean install

2. Téléchargez les paquets compilés *.jar aux répertoires en fonction de votre installation Alfresco :
   • à partir de onlyoffice-alfresco/repo/target/ à /webapps/alfresco/WEB-INF/lib/ pour le répertoire Alfresco.
   • à partir de onlyoffice-alfresco/share/target/ à /webapps/share/WEB-INF/lib/ pour Share.

3. (Optionnel) Modifiez le fichier alfresco-global.properties afin de spécifier les noms d'hôte corrects, ports ouverts et protocoles car alfresco et share sont déployés en tant que deux services séparés.

   alfresco.host=<hostname>
   alfresco.port=443
   alfresco.protocol=https
   
   share.host=<hostname>
   share.port=443
   share.protocol=https

4. Redémarrez Alfresco

   sudo ./alfresco.sh stop
   sudo ./alfresco.sh start

5. Vérifiez si le module est inscrit sur la liste à /share/page/console/admin-console/module-package.

Configurer ONLYOFFICE et le paquet de modules Alfresco

Passez à Console d'Administration Alfresco. Ouvrez http:///alfresco/s/onlyoffice/onlyoffice-config et configurez les paramètres suivants :

Les paramètres du Serveur de documents :

• Adresse du Service de modification de documents - indiquez l'adresse URL du Service de modification de documents.
• Clé secrète - indiquez la clé secrète utilisée pour signer les données. Pour en savoir plus, consultez la section de l'article Activer le jeton JWT pour intégrer ONLYOFFICE et Alfresco.

Paramètres avancés du serveur :

• Adresse du Service de modification de documents pour les demandes internes du serveur Alfresco - spécifiez l'adresse utilisée pour accéder au Service de modification de documents par le serveur Alfresco.
• Adresse su serveur Alfresco pour les demandes internes du Service de modification de documents - spécifiez l'adresse utilisée pour accéder au serveur Alfresco par le Service de modification de documents.

Paramètres communs :

• Ignorer le Certificat SSL - désactive SSL.
• Activer Force Save - permet d'enregistrer les modifications du document directement au stockage Alfresco après avoir cliqué sur le bouton Enregistrer (lorsque la fonction est désactivée le document est enregistré en cache de l'éditeur jusqu'à la fermeture du document).
• Enregistrer docx, xlsx, pptx comme une nouvelle version du fichier d'origine après la conversion - lorsque la fonction est désactivée un fichier séparé sera créé et placé dans le même dossier).
• Ouvrir le fichier pour modification - permet aux administrateurs de choisir les formats de documents afin d'apporter des modifications via la conversion en formats OOXML.

Activer le jeton JWT pour intégrer ONLYOFFICE et Alfresco

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.

Afin de protéger vos documents vous avez besoin d'activer la validation du jeton et de spécifier 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: Configurer 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 bash et ouvrez-le. /etc/onlyoffice/documentserver/local.json
2. Activez la validation du jeton en remplaçant la valeur false par true dans trois sections :
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. Spécifiez votre propre clé secrète en remplaçant la valeur secrète par votre propre chaîne de texte dans trois sections. La clé secrète doit être identique.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string

   {
     "services": {
       "CoAuthoring": {
         "token": {
           "enable": {
             "request": {
               "inbox": true,
               "outbox": true
             },
             "browser": true
           }
         },
       "secret": {
           "inbox": {
             "string": "yoursecret"
           },
           "outbox": {
             "string": "yoursecret"
           },
           "session": {
             "string": "yoursecret"
           }
         }
       }
     }
       }
   

4. Enregistrez vos modifications.
5. 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.

Se connecter à la version démo de ONLYOFFICE Docs

Lorsque vous commencez avec la version 5.0.0 du connecteur ONLYOFFICE vous pouvez essayer les éditeurs en ligne ONLYOFFICE avec Alfresco sans installation de ONLYOFFICE Docs.

Pour activer la connexion cochez Se connecter à la version démo de ONLYOFFICE Document Server et cliquez sur le bouton Enregistrer.