ONLYOFFICE¶

Dans cet article :

• ONLYOFFICE. Fonctionnalités principales
• Fonctionnalités de déploiement
• Démarrer après le déploiement d'ONLYOFFICE
• Accès à l'interface Web
• Configuration du secret JWT
• Activation des exemples pour le test
• 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é d'édition collaborative ;
• Compatibilité avec les formats Microsoft Office : Support complet 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 ;
• Suivi des versions : Suivi de l'historique des modifications avec la possibilité de revenir à une version précédente ;
• Plugins et intégrations : Extension des fonctionnalités via plugins et intégration avec les systèmes de stockage populaires ;
• Sécurité : Support pour les jetons JWT pour protéger l'API et le chiffrement des données lors de la transmission ;
• API pour 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¶

• Déploiement en conteneur - le système est livré avec Docker et des conteneurs préconfigurés pour un déploiement rapide.
• Conteneurs clés :
  • onlyoffice-docs - conteneur principal d'ONLYOFFICE ;
  • nginx-nginx-1 - serveur web Nginx avec support SSL via Certbot (jonasal/nginx-certbot:latest).
• Configuration réseau :
  • Ports externes : 80 (HTTP), 443 (HTTPS) ;
  • Port interne ONLYOFFICE : 8080 (redirigé vers le hôte : 0.0.0.0:8080->80/tcp) ;
  • Acquisition automatique de certificats SSL via Let's Encrypt.
• Directoires clés :
  • /etc/onlyoffice - fichiers de configuration d'ONLYOFFICE à l'intérieur du conteneur ;
  • /var/lib/onlyoffice - données de l'application ;
  • /var/log/onlyoffice - journaux des opérations système ;
  • /var/www/onlyoffice - répertoire racine de l'application web ;
  • /var/www/onlyoffice/documentserver - répertoire principal du Document Server.

Démarrer après le déploiement d'ONLYOFFICE¶

Après le paiement de l'ordre à l'email spécifié lors de l'enregistrement, une notification concernant la disponibilité du serveur sera envoyée. Elle inclura l'adresse IP du VPS ainsi que les identifiants pour se connecter. Nos clients gèrent leur matériel via le panneau de gestion des serveurs et l'API — Invapi.

Les données d'autorisation peuvent être trouvées dans la section Information >> Tags du panneau de contrôle du serveur ou dans l'email envoyé :

• Lien pour accéder au panneau web interface d'ONLYOFFICE : dans le tag webpanel ;
• Login et Mot de passe pour gérer le serveur : envoyés par email à la livraison du serveur.

Accès à l'interface Web¶

Vérification de la fonctionnalité d'ONLYOFFICE¶

1. Ouvrez un navigateur web et allez vers le lien depuis le tag webpanel ;

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

   

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

Vérification du statut du service¶

Pour vérifier le statut des conteneurs, exécutez la commande 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¶

Vérification de la valeur actuelle du secret JWT¶

Le secret JWT est utilisé pour protéger l'API du Document Server. Pour voir 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 depuis des systèmes externes vers ONLYOFFICE ;
• secret.outbox.string - pour les requêtes sortantes d'ONLYOFFICE vers des systèmes externes ;
• secret.session.string - pour les sessions internes et les interactions entre 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

docker exec -it onlyoffice-docs /bin/bash

nano /etc/onlyoffice/documentserver/local.json

"secret": {
  "inbox": {
    "string": "votre_secret_unique_pour_les_requêtes_entrant"
  },
  "outbox": {
    "string": "votre_secret_unique_pour_les_requêtes_sortant"
  },
  "session": {
    "string": "votre_secret_unique_pour_sessions"
  }
}

docker restart onlyoffice-docs

docker logs onlyoffice-docs --tail 100

Activation des exemples pour le test¶

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 :

Lancer le service 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 textuels ;
   • Spreadsheet - pour créer des tableurs ;
   • Presentation - pour créer des présentations ;
   • PDF form - pour travailler avec les formulaires PDF.

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

Pour installer ce logiciel en utilisant l'API, suivez les instructions.

Une partie du contenu de cette page a été créée ou traduite par IA.