Connectez Collabora Online à ownCloud Infinite Scale

Utilisez le service Collaboration d'ownCloud Infinite Scale comme passerelle WOPI entre l'interface web et Collabora Online. Pour une nouvelle installation, la solution la plus sûre est ocis_fulll'exemple Docker Compose modulaire officiel d'ownCloud, qui inclut Infinite Scale, Collaboration, Collabora et Traefik. Configurez les URL publiques d'Infinite Scale, de Collabora et de WOPI, utilisez des certificats TLS valides et assurez-vous que tous les secrets de service restent cohérents. Ne configurez pas Infinite Scale comme s'il s'agissait d'un serveur ownCloud classique.

Cette distinction est confirmée dans la documentation actuelle d'ownCloud : Infinite Scale intègre les suites bureautiques via WOPI et son service de collaboration. Ce service remplace l'ancien cs3org/wopiserveur externe dans les versions plus récentes ; par conséquent, les administrateurs qui mettent à niveau un déploiement plus ancien doivent suivre les instructions de migration correspondant à leur version installée.

1. Vérifiez les prérequis de version et de réseau.

Veuillez vérifier la version exacte d'Infinite Scale avant toute installation. La documentation ownCloud actuelle mentionne le service Collaboration dans la documentation de développement 9.0 et précise qu'il doit être démarré séparément lorsque Infinite Scale fonctionne en mode supervisé. L'exemple d'installation complète d'ownCloud indique également que la configuration dépend des versions contenant le service Collaboration et n'est pas compatible avec les versions de production 5.x. Utilisez la documentation et les fichiers Compose correspondant à votre version installée ; ne copiez pas un exemple de déploiement continu dans un système de production plus ancien sans avoir vérifié la compatibilité.

Pour un déploiement public, prévoyez des noms d'hôtes distincts, tels que `<nom_hôte>` cloud.example.com, ` <nom_hôte office.example.com>` et ` wopi.example.com<nom_hôte>`. Le navigateur doit pouvoir accéder aux URL du cloud et de Collabora, tandis que Collabora doit pouvoir accéder au point de terminaison WOPI exposé par Infinite Scale. Le DNS, les pare-feu et l'authentification TLS doivent être fonctionnels dans les deux sens. Un hôte accessible depuis votre ordinateur portable mais pas depuis le conteneur Collabora ne suffit pas.

L'exemple de déploiement d'ownCloud utilise Traefik comme proxy inverse et requiert un certificat SSL valide pour la configuration du serveur. Son environnement de test local peut utiliser des certificats auto-signés, mais les installations publiques ne doivent pas désactiver la vérification des certificats de manière automatique. Choisissez les noms d'hôtes et les certificats que vous utiliserez avant de configurer la pile.

2. Commencez par l'exemple Compose correspondant d'ownCloud.

1. Consultez le guide de déploiement officiel d'ownCloud pour la solution oCIS modulaire complète avec WebOffice et le répertoire d'exemples ocis_full correspondant . Pour la production, utilisez une version ou une étiquette correspondant à votre version d'Infinite Scale plutôt que d'utiliser la branche de développement du dépôt.
2. Consultez le .envfichier d'exemple. Attribuez les noms d'hôte OCIS_DOMAIN, COLLABORA_DOMAIN, et WOPISERVER_DOMAINà votre serveur. L'exemple active Collabora avecCOLLABORA=:collabora.yml ; conservez ce paramètre si vous souhaitez utiliser Collabora comme éditeur bureautique.
3. Définissez des identifiants d'administrateur robustes et privés, et suivez les recommandations TLS de production de l'exemple. Ne conservez pas les mots de passe d'exemple. Si la version du dépôt a modifié les noms des variables d'environnement ou l'organisation des fichiers, utilisez les fichiers de la même version étiquetée plutôt que de mélanger les instructions de versions différentes.
4. Avant de démarrer Compose, vérifiez sa configuration. Assurez-vous que les services Collabora, Collaboration, Infinite Scale et proxy partagent le même réseau et la même configuration. Le guide ownCloud précise que si Collaboration s'exécute dans un conteneur distinct, la configuration Infinite Scale et les secrets générés doivent être partagés avec les autres services.

L'exemple de déploiement présenté est une pile intégrée, et non une configuration universelle applicable à toutes les installations existantes. Si vous utilisez déjà Infinite Scale avec systemd, Kubernetes ou un proxy inverse personnalisé, conservez ce modèle de déploiement et configurez le service Collaboration et App Registry en suivant la documentation de cette version, plutôt que de déployer une seconde pile complète.

3. Connecter la collaboration à Collabora avec WOPI

Les paramètres principaux définissent l'URL de l'éditeur et la source WOPI accessible depuis l'extérieur. Dans la documentation actuelle du service, COLLABORATION_APP_NAMEcorrespond au nom d'affichage de l'application, COLLABORATION_APP_PRODUCTidentifie le produit, COLLABORATION_APP_ADDRpointe vers Collabora et COLLABORATION_WOPI_SRCcorrespond à l'URL utilisée par Collabora pour lire et écrire des fichiers via Infinite Scale. Voici un exemple de configuration :

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Utilisez les URL publiques et le format de variable requis par votre déploiement. Si les services communiquent sur un réseau interne de conteneurs, l'adresse interne peut convenir dans un contexte, tandis que l'URL accessible via le navigateur doit être utilisée dans un autre. N'utilisez pas un nom d'hôte spécifique au conteneur pour remplacer une valeur que Collabora doit résoudre en externe.

Le service Collaboration requiert également les valeurs d'exécution Infinite Scale suivantes : `<nom_de_l'instance>` OCIS_URL, OCIS_JWT_SECRET` OCIS_REVA_GATEWAY<nom_de_l'instance>` et ` MICRO_REGISTRY_ADDRESS<nom_de_l'instance>`. Ces valeurs doivent correspondre à l'instance en cours d'exécution ; l'exemple complet officiel fournit les relations de service pour son propre réseau Compose. N'inventez pas de nouveaux secrets pour un seul service et ne désactivez pas les vérifications de clés de preuve WOPI pour contourner une incompatibilité. Gardez la vérification des certificats activée pour les certificats publics de confiance ; `<nom_de_l'instance>` COLLABORATION_APP_INSECUREest documenté uniquement comme option pour un certificat d'application WOPI auto-signé, et non comme solution de production générale.

Le registre d'applications détermine l'application Office affichée pour chaque type MIME et celle qui s'ouvre par défaut. Si Collabora est en cours d'exécution mais que les documents ne proposent pas l'option « Ouvrir avec », vérifiez la configuration du type MIME dans le registre et sa default_appvaleur. Le nom utilisé doit correspondre au nom de l'application Office configurée. ownCloud documente cette configuration sous forme de fichier YAML ; les variables d'environnement ne remplacent pas le mappage des types MIME.

4. Démarrer, tester et diagnostiquer l'intégration

À l'aide de l'exemple officiel Compose, validez la configuration rendue, puis démarrez la pile depuis son répertoire de déploiement :

docker compose config
docker compose up -d

Si vous n'utilisez pas l'exemple Compose, commencez par démarrer les services Gateway, App Provider et Collabora. En mode supervisé, la documentation ownCloud indique qu'il faut démarrer Collabora explicitementocis collaboration server ; ce service ne démarre pas automatiquement. Assurez-vous que les variables d'environnement requises sont renseignées dans le processus du service Collabora avant de le démarrer.

1. Ouvrez https://office.example.com/hosting/discoverydans un navigateur. Un point de terminaison accessible devrait renvoyer le XML de découverte de Collabora plutôt qu'une erreur DNS, TLS ou de proxy.
2. Connectez-vous à Infinite Scale, ouvrez un document compatible et choisissez Collabora si l'interface propose plusieurs applications bureautiques. Testez ensuite un fichier existant et, si cette option est activée dans le registre d'applications, la création d'un nouveau document.
3. Effectuez une petite modification, attendez que l'indicateur d'enregistrement se stabilise, fermez l'éditeur et rouvrez le fichier pour confirmer que la modification a bien été prise en compte.
4. Si l'éditeur ne s'ouvre pas, consultez les journaux d'Infinite Scale Collaboration et du fournisseur d'applications, les journaux de Collabora et les journaux du proxy inverse horodatés simultanément. L'erreur « Hôte WOPI non autorisé » indique un problème de configuration de confiance WOPI de Collabora ; un échec de rappel ou une erreur TLS indique un problème d'accessibilité de l'URL ou de confiance du certificat ; une option d'application manquante indique un problème avec le registre d'applications.

L'intégration réussie signifie que le navigateur charge l'éditeur, que la connexion WOPI atteint Infinite Scale et que les modifications sont conservées après la réouverture. Les noms exacts des conteneurs, le câblage des URL et l'emplacement des fichiers de configuration dépendent de la version d'Infinite Scale et de la méthode de déploiement. Consultez la documentation ownCloud correspondant à votre version pour plus de détails, notamment lors de la migration depuis l'ancien serveur WOPI externe.

Références : configuration du service ownCloud Collaboration , configuration d’ownCloud App Registry et notes de version et de migration d’Infinite Scale .