Configurer le connecteur ONLYOFFICE pour Liferay

Passez à Control Panel -> Configuration -> System Settings (Panneau de configuration -> Configuration -> Paramètres du système). Dans la section Platform (Plateforme) sélectionnez la catégorie Connectors (Connecteurs) et ensuite ONLYOFFICE.

Ici vous pouvez configurer les paramètres suivants:

• ONLYOFFICE Docs address (Adresse d'ONLYOFFICE Docs) - indiquez l'adresse URL du Service de modification des documents.
  ImportantL'adresse d'ONLYOFFICE Docs doit être accessible sur Liferay et l'adresse de Liferay doit être accessible sur ONLYOFFICE Docs.
• ONLYOFFICE Docs address for internal requests from the server (Adresse d'ONLYOFFICE Docs pour les demandes internes du serveur) - indiquez l'adresse utilisée pour accéder au Service de modification des documents à partir du serveur Liferay.
• Server address for internal requests from ONLYOFFICE Docs (Adresse du serveur pour les demandes internes d'ONLYOFFICE Docs) - indiquez l'adresse utilisée pour accéder à Liferay depuis le Service de modification des documents.
• Secret Key (Clé secrète) - indiquez la clé secrète utilisée pour signer des 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é Liferay: 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 Liferay.
• Enable Force Save (Activer la sauvegarde forcée) - activez cette option pour que les versions intermédiaires du document soient gardées lors de l'édition.
• Enable ONLYOFFICE Web Preview (Activer l'aperçu Web pour ONLYOFFICE) - activer cette option pour afficher l'aperçu du fichier.

Une fois l'application d'intégration configurée, cliquez sur Save (Enregistrer) pour valider les modifications.

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

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.