ONLYOFFICE¶

Dans cet article

• ONLYOFFICE. Fonctionnalités principales
• Fonctionnalités de déploiement
• Premiers pas après le déploiement d'ONLYOFFICE
• Accès à l'interface web
• Configuration du secret JWT
• Activation des exemples pour les tests
• Commande d'un serveur avec ONLYOFFICE via l'API

Dans cet article : - ONLYOFFICE. Fonctionnalités principales - Fonctionnalités de déploiement - Premiers pas après le déploiement d'OnlyOffice - Accès à l'interface web - Configuration du secret JWT - Activation des exemples pour les tests - Commande d'un serveur avec ONLYOFFICE via l'API

ONLYOFFICE. Fonctionnalités principales¶

• Édition de documents en temps réel : Éditeurs complets pour DOCX, XLSX, PPTX avec capacités d'édition collaborative ;
• Compatibilité avec les formats Microsoft Office : Prise en charge complète des formats MS Office, y compris le formatage complexe ;
• Édition collaborative : Édition simultanée de documents par plusieurs utilisateurs avec suivi des modifications ;
• Commentaires et chat intégrés : Outils pour discuter des documents directement dans l'interface de l'éditeur ;
• Contrôle de version : Suivi de l'historique des modifications avec possibilité de revenir aux versions précédentes ;
• Plugins et intégrations : Extension des fonctionnalités via des plugins et l'intégration avec des systèmes de stockage populaires ;
• Sécurité : Prise en charge des jetons JWT pour protéger l'API et le chiffrement des données lors de la transmission ;
• API pour les développeurs : API REST pour l'intégration avec des applications personnalisées ;
• Support mobile : Interface adaptative pour tablettes et smartphones.

Fonctionnalités de déploiement¶

Premiers pas après le déploiement d'ONLYOFFICE¶

Après le paiement de la commande, une notification concernant la disponibilité du serveur sera envoyée à l'adresse e-mail spécifiée lors de l'inscription. Elle contiendra l'adresse IP du VPS ainsi que les identifiants de connexion (nom d'utilisateur et mot de passe). Les clients de notre entreprise gèrent les équipements via le panneau de gestion des serveurs et l'API — Invapi.

Les données d'autorisation peuvent être trouvées dans l'onglet Information >> Tags du panneau de contrôle du serveur ou dans l'e-mail envoyé :

• Lien d'accès au panneau d'interface web ONLYOFFICE : dans la balise webpanel ;
• Login et Password pour la gestion du serveur : envoyés par e-mail lors de la livraison du serveur.

Accès à l'interface web¶

Vérification du fonctionnement d'ONLYOFFICE¶

1. Ouvrez un navigateur web et accédez au lien de la balise webpanel ;

2. Vous devriez voir la page d'accueil d'ONLYOFFICE :

   

3. Pour vérifier le fonctionnement de l'éditeur, utilisez les exemples intégrés (voir la section "Activation des exemples pour les tests").

Vérification de l'état du service¶

Pour vérifier l'état des conteneurs, exécutez la commande suivante sur le serveur :

docker ps

CONTAINER ID   IMAGE                          STATUS        PORTS                    NAMES
527cd331a316   jonasal/nginx-certbot:latest   Up 19 hours                           nginx-nginx-1
e32700b1ac75   onlyoffice/documentserver      Up 19 hours   0.0.0.0:8080->80/tcp    onlyoffice-docs

Configuration du secret JWT¶

Affichage du secret JWT actuel¶

Le secret JWT est utilisé pour protéger l'API du serveur de documents. Pour afficher sa valeur actuelle :

sudo docker exec e32700b1ac75 /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

Structure des jetons JWT¶

ONLYOFFICE utilise trois types de secrets JWT à des fins différentes :

• secret.inbox.string - pour les requêtes entrantes des systèmes externes vers ONLYOFFICE ;
• secret.outbox.string - pour les requêtes sortantes d'ONLYOFFICE vers les systèmes externes ;
• secret.session.string - pour les sessions internes et les interactions entre les composants.

Modification des secrets JWT¶

Pour modifier les secrets JWT, suivez ces étapes :

1. Créez une sauvegarde de la configuration :

   docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup
   

2. Connectez-vous au conteneur OnlyOffice :

   docker exec -it onlyoffice-docs /bin/bash
   

3. Modifiez le fichier de configuration :

   nano /etc/onlyoffice/documentserver/local.json
   

4. Trouvez la section services.CoAuthoring.secret et modifiez les valeurs :

   "secret": {
     "inbox": {
       "string": "your_unique_secret_for_incoming_requests"
     },
     "outbox": {
       "string": "your_unique_secret_for_outgoing_requests"
     },
     "session": {
       "string": "your_unique_secret_for_sessions"
     }
   }
   

5. Enregistrez le fichier et quittez l'éditeur (Ctrl+X, puis Y, puis Entrée) ;
6. Redémarrez le conteneur pour appliquer les modifications :

   docker restart onlyoffice-docs
   

7. Vérifiez que le service a démarré correctement :

   docker logs onlyoffice-docs --tail 100
   

Activation des exemples pour les tests¶

ONLYOFFICE inclut des exemples intégrés pour tester les éditeurs de documents. Par défaut, ils sont désactivés.

Activation des exemples¶

Pour activer les exemples de test, exécutez les commandes suivantes :

Démarrer le service d'exemple :

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example

sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

1. Ouvrez dans un navigateur : https://votre-domaine/welcome/ ;
2. Vous verrez une page avec des exemples d'éditeurs ;
3. Cliquez sur n'importe quel type de document pour tester :
   • Document - pour créer des documents texte ;
   • Spreadsheet - pour créer des feuilles de calcul ;
   • Presentation - pour créer des présentations ;
   • PDF form - pour travailler avec des formulaires PDF.

Commande d'un serveur avec ONLYOFFICE via l'API¶