Vous pouvez activer l'aperçu des fichiers de Kopano WebApp sans installer le package « FileViewer » séparément, conformément à la configuration documentée. En revanche, MDM est un plugin distinct qui doit être installé et connecté à Z-Push. Cette distinction est importante : le manuel d'administration de WebApp décrit l'aperçu via [nom du plugin manquant] ENABLE_FILE_PREVIEWER, tandis que le manuel MDM décrit un package dédié, un fichier de configuration et ses dépendances. L'installation du mauvais module complémentaire « Fichiers » empêchera l'activation de l'aperçu.
Ce guide s'adresse aux administrateurs d'un déploiement Kopano WebApp existant. Les manuels WebApp et MDM publiés par Kopano constituent une documentation obsolète ; assurez-vous donc que les noms des packages et les paramètres correspondent exactement aux versions de WebApp, PHP, Z-Push et du système d'exploitation que vous utilisez avant toute modification en production. Les étapes ci-dessous expliquent la procédure à suivre et comment la vérifier en toute sécurité.
Vous parlez de l'aperçu des fichiers ou du plugin Kopano Files ?
Utilisez le paramètre de prévisualisation de fichiers intégré lorsque les utilisateurs doivent prévisualiser les pièces jointes compatibles dans l'application Web. L'option d'administration documentée ENABLE_FILE_PREVIEWERdétermine si un paramètre de prévisualisation est proposé aux utilisateurs. Le manuel de l'application Web ne mentionne pas qu'il s'agit d'un package FileViewer distinct à installer via un gestionnaire de packages.
Kopano Files fonctionne différemment. Il ajoute une section Fichiers permettant de parcourir et de gérer les comptes de stockage externes, tels que WebDAV ou d'autres services de stockage configurés. Son utilisation peut nécessiter des packages supplémentaires et une configuration du service de stockage. Si votre objectif est d'afficher un aperçu des pièces jointes, commencez par configurer l'outil d'aperçu, et non Kopano Files. Si votre objectif est de connecter un stockage partagé à l'application Web, suivez les instructions du manuel d'utilisation de Files, disponible à la fin de ce document.
Que fait la gestion des appareils mobiles (MDM) et quand est-elle utile ?
Le plugin de gestion des appareils mobiles de Kopano permet d'accéder aux informations et aux actions des appareils mobiles synchronisés avec Kopano via Z-Push. Selon la configuration, les utilisateurs peuvent consulter les détails de l'appareil et effectuer des actions telles que la resynchronisation, la suppression, l'actualisation ou l'effacement. Ce plugin est utile lorsque les utilisateurs ou les administrateurs ont besoin de contrôler les appareils depuis l'application web ; il ne remplace pas Z-Push et n'établit pas la synchronisation mobile par lui-même.
Le manuel de Kopano MDM indique que Z-Push 2.0 ou une version ultérieure et la prise en charge de PHP SOAP sont requis. Si Z-Push est hébergé sur un serveur différent de celui de l'application Web, la configuration MDM doit pointer vers ce serveur Z-Push. Avant toute installation, vérifiez la compatibilité du point de terminaison Z-Push, de l'environnement d'exécution PHP installé et des packages avec votre environnement.
Comment activer l'aperçu des fichiers ?
Commencez par localiser l'application Web active config.phputilisée par votre installation. Dans le cadre d'un déploiement par paquet, elle se trouve généralement sous `/etc/webapp/webapp` /etc/kopano/webapp/, mais les conteneurs et les installations personnalisées peuvent monter la configuration ailleurs. Sauvegardez le fichier avant de le modifier et évitez de créer une deuxième définition si le paramètre existe déjà.
Dans la configuration active, recherchez ENABLE_FILE_PREVIEWER. Le manuel d'administration de l'application web Kopano indique truequ'il est possible d'afficher l'option permettant aux utilisateurs d'activer l'aperçu des fichiers dans leurs paramètres, et falsequ'il est possible de masquer cette option et de désactiver les aperçus pour tous les utilisateurs. Par exemple :
define("ENABLE_FILE_PREVIEWER", true);
Si la ligne existe déjà, modifiez sa valeur plutôt que d'en ajouter une copie define(). Conservez la syntaxe PHP environnante intacte. Si cette ligne n'existe pas, utilisez le modèle ou les instructions de configuration correspondant à votre package WebApp installé au lieu de copier un exemple de configuration complet dans le fichier en production.
Après l'enregistrement, vérifiez la présence d'erreurs de syntaxe PHP à l'aide de l'interpréteur PHP qui héberge l'application Web. Par exemple, si le fichier de configuration se trouve dans le répertoire d'installation standard :
php -l /etc/kopano/webapp/config.php
La vérification syntaxique ne contrôle que l'analyse PHP ; elle ne confirme pas que le paramètre est chargé par le site en cours d'exécution. Connectez-vous en tant qu'utilisateur de test, ouvrez les paramètres de l'application web et vérifiez que l'option de prévisualisation des fichiers est disponible. Activez-la, appliquez la modification, puis ouvrez une pièce jointe compatible avec votre application web. Si le contrôle est absent, vérifiez que vous avez modifié la configuration active, que les plugins et paramètres de l'application web sont disponibles et qu'aucune mise à jour de package ou montage de conteneur ne fournit un autre fichier de configuration.
Comment installer le plugin MDM ?
Utilisez le paquet MDM conçu pour la même version et distribution de Kopano WebApp que le serveur. Le manuel MDM de Kopano documente un paquet pour Debian kopano-webapp-plugins-mdmet un paquet RPM pour les distributions basées sur RPM. Le schéma d'installation pour Debian est présenté ci-dessous ; remplacez l'espace réservé par la version réelle du paquet obtenue auprès de votre source de paquets compatible et fiable :
sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.deb
Ne saisissez pas le caractère réservé aux chevrons littéralement. Si l'installation du paquet signale des dépendances non résolues, utilisez la procédure de gestion des paquets de votre distribution pour les résoudre à partir de dépôts fiables, puis vérifiez que le paquet MDM installé et la version de l'application Web sont compatibles. Évitez de télécharger une version aléatoire du paquet ou de mélanger des versions pour satisfaire une dépendance.
Vérifiez que l'extension PHP SOAP est activée dans l'environnement PHP utilisé par l'application web. Voici une vérification rapide :
php -m | grep -i '^soap$'
Si aucun résultat n'est affiché, installez et activez l'extension SOAP correspondant à la version de PHP et à l'environnement d'exécution du serveur web utilisés par l'application web. La vérification PHP en ligne de commande peut différer de celle effectuée avec PHP-FPM ou le module PHP d'Apache ; par conséquent, comparez la configuration du serveur web si la commande affiche SOAP mais que MDM signale toujours une fonction SOAP manquante.
Comment configurer la connexion au serveur MDM ?
Le manuel MDM publié place ses paramètres dans /etc/kopano/webapp/config-mdm.php. Sauvegardez le fichier, puis vérifiez les options documentées :
PLUGIN_MDM_USER_DEFAULT_ENABLE_MDMcontrôle si le plugin est activé par défaut pour les utilisateurs ; le manuel indique que la valeur par défaut est false.
PLUGIN_MDM_SERVERidentifie le serveur Z-Push ; la valeur par défaut documentée est localhost.
PLUGIN_MDM_SERVER_SSLdoit être défini sur truelorsque la connexion utilise SSL/TLS ; la valeur par défaut documentée est false.
Si WebApp et Z-Push sont hébergés sur des serveurs distincts, remplacez le paramètre de serveur par défaut par l'emplacement réel de Z-Push requis par votre déploiement. Utilisez le protocole et le nom d'hôte corrects, et activez l'option SSL lorsque le point de terminaison utilise HTTPS. Ne rendez pas le point de terminaison public uniquement pour que le plugin réponde ; assurez-vous qu'il reste accessible via le chemin réseau prévu et un certificat valide. Conservez la syntaxe PHP utilisée par le fichier installé.
Le paramètre par défaut n'est pas forcément adapté à toutes les organisations. Vous pouvez autoriser les utilisateurs à activer eux-mêmes la gestion des appareils mobiles (MDM), ou l'activer par défaut si votre politique le permet. Si la configuration de votre application Web désactive globalement les plugins ou bloque le plugin MDM, commencez par corriger ce paramètre central ; la modification du paramètre par défaut spécifique à la MDM ne suffira pas à contourner la désactivation explicite d'un plugin au niveau de l'application Web.
Comment activer la gestion des appareils mobiles (MDM) dans un compte utilisateur ?
Après l'installation et la configuration du package, connectez-vous à l'application Web et ouvrez les Paramètres, puis l'onglet Plugins. Sélectionnez MDM et appliquez les modifications. Le manuel MDM indique que la vue d'ensemble de l'appareil apparaît dans un onglet MDM distinct des Paramètres et comprend les informations de l'appareil, la dernière synchronisation et un identifiant d'appareil. Si le plugin n'est pas listé, vérifiez d'abord que les fichiers du package sont installés dans le répertoire de plugins actif de l'application Web et que les paramètres globaux des plugins ne le masquent ni ne le désactivent.
Effectuez un test avec un compte disposant déjà d'un appareil synchronisé via Z-Push. Si la liste des appareils est vide, vérifiez si ce compte possède un appareil Z-Push, si le serveur MDM est configuré pour pointer vers le service Z-Push approprié et si PHP SOAP est accessible au processus de l'application web. Consultez les journaux de l'application web et de Z-Push relatifs à une requête de test avant de modifier les paramètres serveur non liés à Z-Push.
Que devez-vous savoir avant d'utiliser Wipe or Remove ?
Considérez les actions MDM comme des commandes opérationnelles, et non comme de simples boutons d'actualisation. Le manuel MDM de Kopano avertit que la fonction « Effacer » supprime toutes les données de l'appareil et recommande la prudence. Testez l'interface sur un appareil non critique et familiarisez-vous avec la procédure de récupération de l'organisation avant de proposer la fonction « Effacer » aux utilisateurs. Vérifiez l'identifiant de l'appareil cible et l'utilisateur avant de lancer la fonction.
La suppression a également des conséquences : le manuel précise que retirer un appareil de la liste implique que l’utilisateur supprime puis reconnecte le compte sur le téléphone pour que l’appareil réapparaisse. La resynchronisation lance une nouvelle synchronisation ; l’actualisation met à jour la liste des appareils affichés. N’utilisez pas l’option « Effacer » comme solution de dépannage générale pour un appareil dont la synchronisation est simplement lente.
Comment pouvez-vous vérifier ces deux fonctionnalités ?
Pour la prévisualisation des fichiers, vérifiez que l'utilisateur peut voir et activer le paramètre, puis ouvrir une pièce jointe compatible sans la télécharger au préalable. Pour la gestion des appareils mobiles (MDM), assurez-vous que l'utilisateur test peut voir les informations attendues sur l'appareil et que les détails de la dernière synchronisation correspondent à un appareil connu pour se synchroniser via Z-Push. Testez d'abord des actions à faible risque telles que l'actualisation ou la resynchronisation. Désactivez ou limitez l'effacement conformément à la politique de votre organisation jusqu'à ce que vous ayez validé son impact.
Si les commandes de prévisualisation sont absentes, vérifiez la configuration de l'application Web active et les paramètres utilisateur. Si la gestion des appareils mobiles (MDM) est absente ou n'affiche aucun appareil, vérifiez la compatibilité des packages, le protocole SOAP PHP, le chemin de configuration MDM, l'hôte Z-Push et les restrictions globales des plugins. Les manuels publiés par Kopano décrivent les noms des paramètres et la structure des packages, mais ne garantissent pas la compatibilité avec toutes les distributions et versions PHP actuelles ; référez-vous à la documentation du package correspondant à votre version de serveur.
Références officielles de Kopano