Strapi

Exigences

• ONLYOFFICE Document Server v7.1 (version serveur ou cloud) ou version ultérieure

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

  Veuillez consulter la documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.
• Strapi v4.2.0 ou version ultérieure
• Connecteur ONLYOFFICE v1.1.0 pour Strapi

Installer le module d'intégration ONLYOFFICE pour Strapi

1. Pour permettre d'insérer un cadre avec l'éditeur et de télécharger api.js, remplacez la ligne strapi::security dans le fichier strapi/config/middlewares.js par la configuration suivante:

   
   {
     name: "strapi::security",
     config: {
       contentSecurityPolicy: {
         useDefaults: true,
         directives: {
           "script-src": ["'self'", "https:", "http:"],
           "frame-src": ["'self'", "https:", "http:"],
         },
       },
     }
   },  
                       

   Si cette configuration existe déjà, vous n'avez qu'à ajouter les directives.

2. Installez le module complémentaire à votre projet Strapi:

   npm install onlyoffice-strapi --save

3. Restaurez et redémarrez Strapi afin d'inclure le module complémentaire ONLYOFFICE dans l'interface utilisateur d'administration. Exécutez:

   
   # using yarn
   yarn build
   yarn develop      
   
   # using npm
   npm run build
   npm run develop
   

   Dès maintenant le module d'intégration ONLYOFFICE pour Strapi est installé est prêt à être configuré. Le module complémentaire est accessible à partir du panneau gauche dans la section Plugins (Modules complémentaire) sous le nom ONLYOFFICE.

   

Configurer le module d'intégration ONLYOFFICE pour Strapi

Pour configurer le module d'intégration ONLYOFFICE pour Strapi:

1. Accédez à la section Settings (Paramètres) à partir du panneau gauche.
2. Dans la section Global settings (Paramètres globaux) cliquez sur l'élément de menu ONLYOFFICE.
3. Sur la page de paramètres ONLYOFFICE, saisissez Document server address (Adresse du serveur de documents), c'est-à-dire l'URL d'ONLYOFFICE Docs installé.
   L'adresse d'ONLYOFFICE Docs doit être accessible sur Strapi et l'adresse de Strapi doit être accessible sur ONLYOFFICE Docs.

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.
• 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 Strapi

Un jeton JWT ou JSON Web Token est une chaîne de caractères qui est envoyé par un client à un serveur via une requête HTTP pour valider l'authenticité du client. Le jeton JWT est enregistré uniquement côté client pour protéger la transmission des données et signer numériquement.

Le jeton est généré selon le standard JWT (JSON Web Tokens). Les jetons sont signés par des clés de serveur, pour que client puisse vérifier la validité du jeton.

ONLYOFFICE Docs valide le jeton. Les données de charge utile sont considérées comme valables et sont utilisés pour remplacer des données correspondantes dans des paramètres principaux. Une fois le jeton non valable, la commande ne sera pas exécutée. Pour en savoir plus, veuillez consulter le Guide de la sécurité des API.

Pour protéger vos documents par un jeton JWT,

1. Accédez à la section Settings (Paramètres) à partir du panneau gauche.
2. Dans la section Global settings (Paramètres globaux) cliquez sur l'élément de menu ONLYOFFICE.
3. Sur la page de configuration ONLYOFFICE, saisissez la clé secrète dans le champ Document server JWT secret key (Clé secrète JWT du serveur de documents). Pour en savoir plus, accédez ici.
   

   Une fois de module complémentaire ONLYOFFICE configuré, vous pouvez commencer à l'utiliser instantanément.