Exportation de fichiers par blocs dans Collabora CODE via WOPI

Pour empêcher les utilisateurs d'exporter un document ouvert dans Collabora Online CODE, configurez votre hôte WOPI pour qu'il renvoie une réponse contenant les informations "DisableExport": truedu document . La documentation d'intégration de Collabora décrit cette action comme désactivant la fonctionnalité d'exportation ; une fois configurée, l'option « Télécharger sous » du menu est également masquée. Cette configuration modifie uniquement l'interface et n'est donc pas la solution appropriée pour interdire l'exportation. Consultez les propriétés de réponse étendues de la méthode CheckFileInfo de Collabora .CheckFileInfoHideExportOption

Utilisez l'autorisation WOPI, et non un paramètre de menu uniquement.

Dans une intégration WOPI, CODE est le composant d'édition. Votre service de stockage ou d'application fait office d'hôte WOPI et fournit les informations relatives à chaque fichier lorsque Collabora ouvre un document. C'est donc l'hôte qui détermine si un utilisateur donné est autorisé à exporter un fichier spécifique.

Dans l'objet JSON renvoyé par le CheckFileInfopoint de terminaison de l'hôte, incluez la propriété booléenne :

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

Ceci est un extrait illustratif, et non une réponse complète de CheckFileInfo. Conservez les autres champs obligatoires ainsi que les propriétés d'intégration déjà renvoyées par votre hôte. La valeur de la clé doit être un booléen JSON, et non une chaîne de caractères "true". Définissez-la en utilisant la même décision d'autorisation que celle utilisée par votre application pour le fichier et l'utilisateur actuel.

Par exemple, une organisation peut autoriser ses employés à modifier un classeur budgétaire confidentiel tout en leur interdisant d'utiliser les fonctions d'exportation de Collabora. Lorsque l'hôte WOPI ouvre ce classeur pour un membre du personnel, il renvoie une valeur DisableExport: true. Pour un modèle public ou un document ordinaire, l'hôte peut renvoyer une valeur falseconformément à sa politique. Une valeur statique appliquée à chaque document n'est appropriée que si chaque utilisateur et chaque document doivent être soumis à la même restriction.

Mettez à jour l'hôte WOPI qui sert le fichier.

1. Identifiez le point de terminaison d'intégration. Trouvez la route hôte qui répond à la requête WOPI de Collabora CheckFileInfopour le fichier. Dans Nextcloud, ownCloud ou un autre service de stockage, cela implique généralement de modifier la couche d'intégration ou de stratégie qui génère la réponse ; la modification de la configuration globale du conteneur Collabora ne remplace pas les autorisations spécifiques à chaque fichier sur l'hôte.
2. Appliquez la règle au périmètre approprié. Déduisez la valeur de l'utilisateur authentifié, de la classification des fichiers, des autorisations de partage ou d'une autre règle de votre application. Pour une politique simple applicable à tous les utilisateurs, renvoyez « vrai » pour chaque document concerné. Évitez de vous fier à une préférence du menu du navigateur ou à une valeur fournie par le client.
3. Renvoie la valeur booléenne dans CheckFileInfo. Assurez-vous que la réponse est un JSON valide et qu'elle inclut la propriété dans la réponse reçue par Collabora. Une modification de la stratégie au niveau du code peut nécessiter le déploiement ou le redémarrage de l'application hôte WOPI, selon son framework ; le code lui-même peut ne pas nécessiter de modification de configuration si l'hôte fournit dynamiquement le champ.
4. Rouvrez le document. Fermez la session d'édition en cours et rouvrez le fichier avec le compte concerné. CheckFileInfo est consulté lors de l'ouverture du document ; par conséquent, une session déjà ouverte peut ne pas refléter la modification des autorisations.

Le fichier, la classe, le paramètre ou l'interface d'administration exacts varient selon l'hôte WOPI et la version du produit. La documentation de Collabora définit le champ, mais ne propose pas de paramètre universel pour Nextcloud ou les applications tierces. Si votre hébergeur n'affiche aucune restriction de téléchargement, consultez la documentation d'administration actuelle du produit ou implémentez la stratégie dans son chemin de réponse WOPI pris en charge.

Quand faut-il également définir HideExportOption ?

Activez HideExportOptioncette option truesi vous souhaitez masquer le bouton « Télécharger » sans interdire l'exportation. Pour une restriction effective, privilégiez l' option correspondanteDisableExport: true ; le guide d'intégration de Collabora précise que cela implique également le masquage du menu. Définir les deux champs sur « true » permet de rendre l'intention explicite dans une intégration, mais cela ne devrait pas être nécessaire pour le comportement documenté.

Ne confondez pas cela avec les extra_export_formatsentrées du fichier coolwsd.xml. Le modèle de configuration actuel de Collabora indique clairement que la désactivation de ces formats optionnels les masque uniquement visuellement et n'empêche pas l'exportation côté serveur. Ces options déterminent les formats supplémentaires proposés, et non si un utilisateur est autorisé à exporter un document. Consultez le modèle de configuration actuel de Collabora Online avant de modifier les paramètres globaux.

Ce que cette restriction protège – et ne protège pas –

DisableExportCe paramètre s'applique à la fonctionnalité d'exportation de Collabora pour la session. Il est utile lorsque les utilisateurs doivent modifier un fichier dans le navigateur sans utiliser les fonctions d'exportation ou de téléchargement de l'éditeur. Il ne supprime pas automatiquement l'accès de l'utilisateur au fichier original sur le service de stockage. Si l'hôte autorise toujours cet utilisateur à télécharger le fichier source ailleurs, le paramètre Collabora ne bloque pas cet accès.

De même, un utilisateur autorisé à consulter le contenu peut copier des informations manuellement, prendre des captures d'écran ou utiliser d'autres fonctionnalités autorisées par votre politique. Ne décrivez pas ce paramètre comme empêchant toute exfiltration de données ou garantissant l'impossibilité de copier le contenu. Pour limiter l'accès à l'original, appliquez également des règles de téléchargement et de partage dans l'application hôte et de stockage WOPI. Si vous exigez qu'un utilisateur ne puisse pas du tout consulter le contenu, bloquez l'accès au document plutôt que de vous fier à un indicateur d'exportation.

Il convient de distinguer le masquage d'un élément d'interface de la désactivation d'une opération. Le modèle de configuration de Collabora fait cette distinction pour ses paramètres optionnels de format d'exportation, tandis que le champ de réponse WOPI correspond à la restriction au niveau de l'intégration. La première action simplifie les menus ; la seconde est le paramètre destiné à bloquer les exportations via Collabora. Si une intégration existante se comporte différemment, vérifiez sa version de Collabora et examinez la réponse réelle de CheckFileInfo plutôt que de supposer qu'un produit hôte particulier associe sa propre case à cocher « désactiver le téléchargement » aux deux champs.

Vérifiez la restriction avec un compte de test.

1. Utilisez un compte non administrateur conforme à la politique de restriction et ouvrez un document de test dans une nouvelle session.
2. Vérifiez que l'option « Télécharger sous » de l'éditeur n'est plus disponible. Si elle apparaît toujours, examinez la réponse CheckFileInfo générée pour cet utilisateur et ce fichier ; assurez-vous que le champ est de type booléen trueet que la nouvelle réponse est bien fournie.
3. Testez l'exportation via l'interface Collabora standard. La politique de l'hôte doit se refléter dans le comportement de l'éditeur. Ne concluez pas que le contrôle est appliqué simplement parce que l'élément de menu est masqué.
4. Vérifiez séparément l'application de stockage : n'essayez son propre chemin de téléchargement que si votre plan de test le permet. Un téléchargement réussi signifie que la politique d'accès aux fichiers sources l'autorise toujours, même si Collabora bloque les exportations.
5. Ouvrez un document pour un utilisateur autorisé à exporter et vérifiez que votre système d'hébergement renvoie bien l'autorisation prévue. Cela permet de détecter les règles appliquées globalement par erreur.

Pour plus de détails sur la mise en œuvre, consultez la documentation d'intégration WOPI de Collabora et le modèle de configuration de projet . Le comportement de CODE peut varier selon les versions et les intégrations hôtes ; il est donc important de vérifier la réponse et le résultat sur la version déployée. Aucune garantie n'est donnée quant au test d'une version hôte ou d'un exemple de déploiement particulier.