Nextcloud

Exigences

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

  Vous avez besoin d'une instance d'ONLYOFFICE Docs qui puisse être résolue et joignable à la fois depuis Nextcloud et depuis tous les clients finaux. ONLYOFFICE Docs doit pouvoir envoyer des requêtes POST directement vers Nextcloud.

  À partir de la version 4.3.0, ONLYOFFICE Docs et Nextcloud peuvent être installés sur des ordinateurs distincts ou sur la même machine. Dans ce dernier cas, vous devrez définir un port personnalisé pour ONLYOFFICE Docs, car ONLYOFFICE Docs et Nextcloud utilisent tous deux le port 80 par défaut.

  Consultez la page de documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.
• Nextcloud v32 (le connecteur est compatible avec Nextcloud jusqu'à la version 34)
• Connecteur ONLYOFFICE v10.1.0 ou ultérieur pour Nextcloud

Installer le connecteur ONLYOFFICE pour Nextcloud

L'administrateur Nextcloud peut installer l'application d'intégration depuis la place de marché intégrée. Pour ce faire, suivez les étapes ci-dessous :

1. Cliquez sur le nom d'utilisateur et sélectionnez Apps (Applications).
2. Accédez à la catégorie Tools (Outils).
3. Recherchez ONLYOFFICE dans la liste des applications disponibles.
4. Cliquez sur le bouton Download and enable (Télécharger et activer).

L'administrateur peut également installer l'application manuellement :

1. Récupérez l'application d'intégration ONLYOFFICE pour Nextcloud. Plusieurs méthodes sont possibles :
   1. Téléchargez la dernière version signée depuis la boutique Nextcloud officielle.
   2. Téléchargez la dernière version signée depuis la page des versions de l'application sur GitHub. Par exemple :

      wget https://github.com/ONLYOFFICE/onlyoffice-nextcloud/archive/refs/tags/vX.X.X.tar.gz

      Où vX.X.X correspond à la version du connecteur souhaitée.

      Décompressez l'archive, par exemple :

      tar -xvzf vX.X.X.tar.gz

      Renommez le dossier en onlyoffice, par exemple

      mv onlyoffice-nextcloud-X.X.X onlyoffice

   3. Clonez le code source de l'application et compilez-le vous-même :

      git clone https://github.com/ONLYOFFICE/onlyoffice-nextcloud.git onlyoffice
      cd onlyoffice
      git submodule update --init --recursive

2. Déplacez le dossier onlyoffice vers le répertoire apps/ du serveur Nextcloud (ou tout autre répertoire utilisé pour connecter des applications) :

   cp -r /root/onlyoffice/ /var/www/html/apps/

3. Accédez au répertoire apps/ :

   cd /var/www/html/apps

4. Modifiez le propriétaire pour pouvoir mettre à jour l'application directement depuis l'interface web de Nextcloud :

   chown -R www-data:www-data onlyoffice

5. Dans Nextcloud, accédez à Settings > Apps > Disabled apps (Paramètres > Applications > Applications désactivées) et cliquez sur Enable (Activer) pour l'application ONLYOFFICE.

ONLYOFFICE Docs et Nextcloud peuvent être installés sur des ordinateurs distincts ou sur la même machine. Dans ce dernier cas, vous devrez définir un port personnalisé pour le Serveur de documents, car ONLYOFFICE Docs et Nextcloud utilisent tous deux le port 80 par défaut. Vous pouvez également utiliser le Serveur de documents derrière un proxy ; consultez cet article pour savoir comment le configurer.

Configurer le connecteur ONLYOFFICE pour Nextcloud

Pour configurer les paramètres de l'application ONLYOFFICE, accédez à Settings > Administration > ONLYOFFICE (Paramètres > Administration > ONLYOFFICE).

Dans la section Server settings (Paramètres du serveur), indiquez les options suivantes :

• ONLYOFFICE Docs address (Adresse d'ONLYOFFICE Docs) - indiquez l'adresse URL à laquelle le service d'édition de documents est installé. Ce champ est obligatoire. Si vous installez ONLYOFFICE Docs sur un port personnalisé, vous devez indiquer ce port, par exemple : http://127.0. 0.1:8081/
  L'adresse d'ONLYOFFICE Docs doit être accessible depuis Nextcloud, et l'adresse de Nextcloud doit être accessible depuis ONLYOFFICE Docs.
• Disable certificate verification (insecure) (Désactiver la vérification du certificat (non sécurisé)) - cochez cette case pour désactiver la vérification du certificat et permettre à Nextcloud d'établir une connexion avec ONLYOFFICE Docs si vous utilisez un certificat auto-signé pour votre ONLYOFFICE Docs (sinon, Nextcloud ne validera pas le certificat auto-signé et n'autorisera pas la connexion vers ou depuis ONLYOFFICE Docs). Cette solution n'est pas sécurisée et nous vous recommandons vivement de remplacer le certificat par un certificat émis par une autorité de certification.
• Secret key (Clé secrète) - indiquez la clé secrète utilisée pour signer les données.
  À partir d'ONLYOFFICE Docs v7.2, 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 Nextcloud : recherchez votre clé secrète dans le fichier de configuration d'ONLYOFFICE Docs, puis indiquez la même clé secrète dans les paramètres du connecteur. Pour en savoir plus, consultez la section Activer JWT pour l'intégration ONLYOFFICE et Nextcloud de cet article.
• La section Advanced server settings (Paramètres avancés du serveur) peut être utilisée si la configuration de votre réseau n'autorise pas les requêtes entre Nextcloud et ONLYOFFICE Docs via les adresses publiques. Dans ce cas, indiquez les adresses des requêtes internes dans les champs correspondants :
  • Dans le champ ONLYOFFICE Docs address for internal requests from the server (Adresse d'ONLYOFFICE Docs pour les requêtes internes provenant du serveur), indiquez l'adresse utilisée pour accéder au service d'édition de documents depuis Nextcloud.
  • Dans le champ Server address for internal requests from ONLYOFFICE Docs (Adresse du serveur pour les requêtes internes provenant d'ONLYOFFICE Docs), indiquez l'adresse utilisée pour accéder à Nextcloud depuis le service d'édition de documents.

Cliquez sur le bouton Save (Enregistrer). Après l'enregistrement des Server settings (Paramètres du serveur), les sections Common settings (Paramètres communs), Editor customization settings (Paramètres de personnalisation de l'éditeur), Common templates (Modèles communs) et Secure view settings (Paramètres d'affichage sécurisé) apparaissent.

Dans la section Common settings (Paramètres communs), vous pouvez définir les options suivantes :

• Allow the following groups to access the editors (Autoriser les groupes suivants à accéder aux éditeurs) - cochez cette case et sélectionnez les groupes d'utilisateurs autorisés à utiliser les éditeurs ONLYOFFICE dans Nextcloud.
• Restrict access to ONLYOFFICE for files from external storages (Limiter l'accès à ONLYOFFICE pour les fichiers provenant de stockages externes) - cochez cette case pour empêcher les utilisateurs d'ouvrir ou de modifier via ONLYOFFICE des fichiers stockés dans des emplacements de stockage externes. Les administrateurs contrôlent ainsi plus finement les endroits où les documents peuvent être ouverts et modifiés, ce qui est utile dans les environnements soumis à des exigences strictes de sécurité ou de conformité.
• Use ONLYOFFICE to generate a document preview (Utiliser ONLYOFFICE pour générer l'aperçu du document) - cochez cette case pour générer les miniatures via ONLYOFFICE. Cela occupe de l'espace disque.
• Open file in the same tab (Ouvrir le fichier dans le même onglet) - cochez cette case pour ouvrir un fichier dans l'onglet actif du navigateur. Si cette option est décochée, le fichier s'ouvre dans un nouvel onglet du navigateur.
• Provide advanced document permissions using ONLYOFFICE Docs (Accorder des autorisations avancées sur les documents à l'aide d'ONLYOFFICE Docs) - cochez cette case pour pouvoir définir des autorisations supplémentaires sous l'onglet Advanced (Avancé) du panneau du document et pour les fichiers partagés via Nextcloud Teams (anciennement Circles) : Reviewing (Révision) et Commenting (Commentaires) pour les documents texte, Commenting (Commentaires) et Custom filtering (Filtre personnalisé) pour les classeurs, et Form filling (Remplissage de formulaire) pour les formulaires PDF. Pour en savoir plus, consultez la section Commencer à utiliser ONLYOFFICE Docs au sein de Nextcloud de cet article.
• Keep metadata for each version once the document is edited (Conserver les métadonnées de chaque version après modification du document) Cette fonction permet de conserver les métadonnées et d'afficher les modifications de chaque version du document dans l'historique des versions. Cela occupe de l'espace disque. Le bouton Clear (Effacer) permet de supprimer les métadonnées et de libérer de l'espace disque.
• The default application for opening the format (Application par défaut pour ouvrir le format) - permet d'indiquer les formats à associer aux éditeurs ONLYOFFICE. Les formats docx, xlsx et pptx sont sélectionnés par défaut.
  L'ouverture dans les éditeurs ONLYOFFICE ne s'effectue que pour les formats sélectionnés dans cette section.
• Open the file for editing (Ouvrir le fichier pour modification) - permet aux administrateurs de choisir les formats de documents à modifier en les convertissant aux formats OOXML. Les formats csv et txt sont sélectionnés par défaut.
  En raison des restrictions de format, certaines données peuvent être perdues lors de l'enregistrement dans les formats de la liste (csv, odp, ods, odt, rtf, txt).

  Une fois l'option correspondante activée, les documents dans les formats indiqués sont immédiatement convertis et ouverts pour modification dans l'éditeur ONLYOFFICE dès que vous cliquez dessus. Si un format est décoché, le fichier s'ouvre en lecture seule.

Dans la section Editor customization settings (Paramètres de personnalisation de l'éditeur), vous pouvez définir les options suivantes :

• La fonction Keep intermediate versions when editing (forcesave) (Conserver les versions intermédiaires lors de la modification (sauvegarde forcée)) permet d'envoyer toutes les modifications directement vers le stockage lorsque vous cliquez sur le bouton Save (Enregistrer) dans l'interface des éditeurs ONLYOFFICE, afin d'éviter toute perte de données. Lorsque cette option est désactivée, vos modifications sont enregistrées automatiquement dans le cache des éditeurs.
• Sélectionnez les éléments de l'interface des éditeurs à masquer ou à afficher (Chat, En-tête plus compact,  Commentaires et assistance , Aide, En-tête de la barre d'outils monochrome).
• La fonction Review mode for viewing (Mode de révision pour l'affichage) permet de définir le mode d'affichage des révisions par défaut :
  • Balisage - pour mettre en évidence les modifications proposées,
  • Final - pour afficher le document avec les modifications appliquées,
  • Original - pour afficher le document d'origine sans aucune modification.
• La fonction Default editor theme (Thème de l'éditeur par défaut) permet de définir le thème par défaut : Clair, Classique clair ou Sombre.

Dans la section Common templates (Modèles communs), vous pouvez cliquer sur l'icône et télécharger des modèles docx, xlsx ou pptx pour créer de nouveaux documents.

Vous pouvez télécharger ou supprimer un modèle de cette liste à l'aide des icônes correspondantes.

Après l'ajout de modèles dans les paramètres d'administration, les utilisateurs pourront choisir un modèle lors de la création d'un nouveau document à l'aide du bouton ajouter dans l'interface de Nextcloud ou via le menu File > Create new (Fichier > Créer nouveau) dans l'interface des éditeurs ONLYOFFICE.

Dans la section Security (Sécurité), vous pouvez protéger les documents en y intégrant un filigrane, ainsi qu'activer ou désactiver l'exécution des macros.

Après avoir modifié les paramètres de l'application, cliquez sur le bouton Save (Enregistrer) situé sous chaque section pour enregistrer les modifications.

Vérifier la connexion

Vous pouvez vérifier la connexion à ONLYOFFICE Docs à l'aide de la commande occ suivante :

occ onlyoffice:documentserver --check

Un message s'affiche, indiquant soit que la connexion a réussi, soit la cause de l'erreur.

Comment cela fonctionne

L'intégration ONLYOFFICE suit l'API documentée ici.

1. Lors de la création d'un fichier, l'utilisateur accède à un dossier de documents dans Nextcloud et clique sur Document, Classeur ou Présentation dans le menu new (+).
2. Le navigateur appelle la méthode create du contrôleur /lib/Controller/EditorController.php. Cette méthode ajoute une copie d'un fichier du dossier assets au dossier dans lequel l'utilisateur se trouve.
3. Lors de l'ouverture d'un fichier existant, l'utilisateur accède à ce fichier dans Nextcloud et sélectionne l'option de menu Open in ONLYOFFICE (Ouvrir dans ONLYOFFICE).
4. Un nouvel onglet du navigateur s'ouvre et la méthode index du contrôleur /lib/Controller/EditorController.php est appelée.
5. L'application prépare un objet JSON comportant les propriétés suivantes :
   • url - l'URL utilisée par ONLYOFFICE Docs pour télécharger le document ;
   • callbackUrl - l'URL utilisée par ONLYOFFICE Docs pour communiquer l'état de la modification du document ;
   • documentServerUrl - l'URL que le client doit utiliser pour communiquer avec le Serveur de documents ONLYOFFICE (elle peut être définie sur la page des paramètres d'administration) ;
   • key - la valeur UUID+Modified Timestamp qui indique à ONLYOFFICE Docs s'il doit télécharger le document à nouveau ou non.
6. Nextcloud reprend cet objet et construit une page à partir du modèle templates/editor.php en renseignant toutes ces valeurs, afin que le navigateur du client puisse charger l'éditeur.
7. Le navigateur du client envoie une requête à la bibliothèque JavaScript d'ONLYOFFICE Docs et transmet à ONLYOFFICE Docs la configuration DocEditor comportant les propriétés ci-dessus.
8. ONLYOFFICE Docs télécharge ensuite le document depuis Nextcloud et l'utilisateur commence à le modifier.
9. ONLYOFFICE Docs envoie une requête POST à callbackUrl pour informer Nextcloud qu'un utilisateur modifie le document.
10. Lorsque tous les utilisateurs et tous les navigateurs clients ont terminé leurs modifications, ils ferment la fenêtre d'édition.
11. Après 10 secondes d'inactivité, ONLYOFFICE Docs envoie une requête POST à callbackUrl pour informer Nextcloud que les clients ont terminé de modifier le document et l'ont fermé.
12. Nextcloud télécharge une nouvelle version du document, qui remplace l'ancienne.

Activer JWT pour l'intégration ONLYOFFICE et Nextcloud

Pour protéger les documents contre tout accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON Web (JWT). Le jeton est ajouté à la configuration lors de l'initialisation de l'éditeur de documents et lors des échanges de commandes entre les services internes d'ONLYOFFICE Docs. La clé secrète sert à signer le jeton JSON Web et à le valider lors des requêtes adressées à ONLYOFFICE Docs.

À partir d'ONLYOFFICE Docs v7.2, JWT est activé par défaut et la clé secrète est générée automatiquement. Vous devez rechercher votre clé secrète dans le fichier de configuration d'ONLYOFFICE Docs, puis indiquer la même clé secrète dans les paramètres du connecteur.

Étape 1 : recherchez votre clé secrète dans le fichier de configuration d'ONLYOFFICE Docs

1. Ouvrez le fichier local.json avec n'importe quel éditeur de texte disponible.
   • Pour Linux - /etc/onlyoffice/documentserver/local.json
   • Pour Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Pour Docker – accédez au conteneur ONLYOFFICE Docs à l'aide de la commande docker exec -it <containerID> bash et ouvrez /etc/onlyoffice/documentserver/local.json

     Vous pouvez également utiliser la commande suivante pour retrouver 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 indiqué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 indiquée dans trois sections. Vous pouvez remplacer la valeur par défaut par votre propre clé secrète. La clé secrète doit être identique dans les 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 qu'elles prennent effet.
   • Pour Linux :

     sudo supervisorctl restart all

   • Pour Docker :

     docker exec <containerID> supervisorctl restart all

     ou redémarrez l'ensemble du conteneur :

     docker restart <containerID>

Étape 2 : indiquez la même clé secrète dans les paramètres du connecteur

Dans les paramètres du connecteur, indiquez la même clé secrète dans le champ Secret key (Clé secrète) et enregistrez les paramètres.

Se connecter à la version de démonstration d'ONLYOFFICE Docs

À partir de la version 3.0.0 du connecteur ONLYOFFICE, vous pouvez essayer les éditeurs ONLYOFFICE en ligne au sein de Nextcloud sans installer ONLYOFFICE Docs.

Pour activer la connexion, cochez la case Connect to demo ONLYOFFICE Docs server (Se connecter au serveur de démonstration ONLYOFFICE Docs) et cliquez sur le bouton Save (Enregistrer).

Installer Docker et Docker Compose

1. Suivez ces instructions pour télécharger et installer Docker sur votre ordinateur. Docker est un programme qui automatise le développement et la gestion d'applications dans des environnements de conteneurs.
2. Suivez ensuite ces instructions pour télécharger et installer le gestionnaire de paquets Docker Compose, qui permet de décrire et d'exécuter des applications multiconteneurs.

Installer les serveurs ONLYOFFICE Docs et Nextcloud

1. Téléchargez la dernière version du dépôt docker-onlyoffice-nextcloud. Pour ce faire, saisissez la ligne suivante dans l'interface de ligne de commande :

   git clone https://github.com/ONLYOFFICE/docker-onlyoffice-nextcloud

2. Une fois le dépôt téléchargé, accédez au dossier docker-onlyoffice-nextcloud :

   cd docker-onlyoffice-nextcloud

3. Lancez Docker Compose :

   sudo docker-compose up -d

   Après l'exécution de la commande ci-dessus, il peut être nécessaire d'attendre quelques minutes que tous les conteneurs soient opérationnels.

Dans la barre d'adresse du navigateur, saisissez http://localhost pour ouvrir la page de configuration de Nextcloud et créer votre compte administrateur. Indiquez votre Nom d'utilisateur et votre Mot de passe.

Une fois l'assistant terminé, accédez au dossier docker-onlyoffice-nextcloud et exécutez le script de configuration :

sudo bash set_configuration.sh

Vous pouvez désormais créer et modifier des documents dans Nextcloud à l'aide d'ONLYOFFICE Docs, sans configurer aucun paramètre.

Les paramètres du serveur sont définis lors du déploiement, mais vous pouvez ajuster les Common settings (Paramètres communs), les Editor customization settings (Paramètres de personnalisation de l'éditeur), les Common templates (Modèles communs) et les Secure view settings (Paramètres d'affichage sécurisé). Consultez la section Configurer le connecteur ONLYOFFICE pour Nextcloud pour en savoir plus sur les paramètres disponibles du connecteur.

Télécharger les composants nécessaires

Vous devez d'abord installer l'hyperviseur de la machine virtuelle. Choisissez entre VMware Workstation Pro et VirtualBox, puis consultez la documentation pour obtenir des instructions d'installation détaillées.

Téléchargez ensuite ONLYOFFICE-Nextcloud VM pour l'hyperviseur que vous avez choisi.

Importer l'appliance virtuelle

Ouvrez maintenant l'hyperviseur et importez l'appliance virtuelle ONLYOFFICE-Nextcloud. Ce guide explique comment procéder sur les deux plateformes.

Installer l'application

Une fois l'image importée, démarrez la machine virtuelle. Suivez le processus de démarrage à l'aide de l'assistant d'installation, en respectant les étapes ci-dessous.

1. Choisissez votre langue et saisissez la ville la plus proche.
   

   L'assistant récupère les paramètres régionaux, le fuseau horaire et la disposition du clavier par défaut.

2. Configurez votre domaine et vos paramètres réseau. Par défaut, l'adresse IP est obtenue automatiquement. Vous pouvez également indiquer manuellement votre adresse IP, votre masque de réseau et votre passerelle. Saisissez l'adresse du serveur DNS souhaité.
   
3. Sélectionnez les paramètres de votre domaine. L'option Manage users and permissions directly on this system (Gérer les utilisateurs et les autorisations directement sur ce système) est sélectionnée par défaut. Elle permet de créer un nouveau domaine sur ce système. Vous pouvez également vous connecter à un domaine UCS ou Microsoft Active Directory existant.
   
4. Saisissez le nom de votre entreprise et l'adresse e-mail de l'administrateur pour activer ONLYOFFICE (le fichier de licence sera envoyé à cette adresse e-mail), puis créez et confirmez un nouveau mot de passe pour votre compte administrateur.
   
5. Indiquez le nom de domaine complet de ce système ainsi que la base LDAP :
   
6. Vérifiez vos paramètres et assurez-vous que tout est correctement renseigné. Cliquez ensuite sur le bouton Configure System (Configurer le système).
   
7. Une fois la configuration terminée, ONLYOFFICE est prêt à démarrer sur la plateforme UCS que vous venez de créer.
   
   
8. Saisissez votre adresse IP dans la barre d'adresse du navigateur et téléchargez votre fichier ucs.license reçu par e-mail.
9. Pour vous connecter à votre appliance ONLYOFFICE Docs et Nextcloud, cliquez sur Nextcloud dans la section Applications.

   Pour vous connecter à Univention Management Console, cliquez sur LOGIN en haut de la page ou sur System and domain settings (Paramètres du système et du domaine) dans la section Administration.

   Saisissez Administrator dans le champ d'identifiant, ainsi que le mot de passe défini lors de l'enregistrement (voir l'étape 4).

   

Lancer les éditeurs de bureau ONLYOFFICE

Pour connecter les éditeurs de bureau à votre serveur Nextcloud, procédez comme suit :

1. Passez à la section Connect to cloud (Se connecter au cloud) du panneau de gauche.
2. Cliquez sur le bouton du service cloud Nextcloud. Vous pouvez également utiliser le lien Connect now (Se connecter) en bas de la page.
   
3. Si vous avez cliqué sur le bouton Nextcloud service (Service Nextcloud), la fenêtre Connect to cloud office (Se connecter au bureau cloud) s'ouvre avec Nextcloud déjà sélectionné. Si vous avez utilisé le lien Connect now (Se connecter), choisissez le stockage cloud Nextcloud dans la liste déroulante.
   • dans le champ Cloud office URL (URL du bureau cloud), saisissez le nom de domaine ou l'adresse IP de votre serveur Nextcloud. Cliquez ensuite sur le bouton Connect now (Se connecter).
     

   • La page de connexion Nextcloud s'ouvre dans un nouvel onglet de l'interface des éditeurs de bureau.

     • Saisissez le Username or email (Nom d'utilisateur ou e-mail) et le Password (Mot de passe) que vous utilisez pour accéder à votre compte Nextcloud,
     • Cliquez sur le bouton Log in (Se connecter).
     

La section Files (Fichiers) de votre compte Nextcloud s'ouvre. Vous pouvez maintenant modifier vos fichiers existants et en créer de nouveaux, partager vos documents et collaborer dessus avec les utilisateurs Nextcloud à l'aide des éditeurs ONLYOFFICE.