Comment restreindre les options d'exportation de fichiers dans Collabora Online ? (CODE)

Pour restreindre l'exportation de fichiers dans Collabora Online CODE, configurez l'hôte WOPI pour qu'il renvoie, DisableExport: truedans sa CheckFileInforéponse, le fichier et l'utilisateur concernés. Supprimez HideExportOption: trueégalement la commande « Télécharger sous » du menu de l'éditeur. La première propriété désactive la fonction d'exportation de Collabora dans l'interface d'administration ; la seconde contrôle la visibilité. La simple modification de la visibilité ne constitue pas une mesure de contrôle d'accès.

CODE est l'éditeur de documents. Dans une intégration standard, un hôte WOPI distinct, tel que Nextcloud, ownCloud ou une application personnalisée, stocke le fichier original et fournit à Collabora les métadonnées et les autorisations d'exportation. C'est pourquoi les autorisations d'exportation sont généralement configurées dans l'intégration de l'hôte, et non comme une option globale dans le conteneur Collabora coolwsd.xml.

Choisissez la commande qui correspond à l'action

Utilisez les deux premiers champs pour bloquer spécifiquement la fonction « Télécharger sous »/« Exporter » de Collabora. N'ajoutez les autres contrôles que si votre politique couvre également ces actions. L'absence d'un élément de menu ne prouve pas, à elle seule, que les téléchargements sont bloqués.

Déterminez où appliquer la restriction

Commencez par identifier l'application qui stocke le fichier et l'ouvre dans Collabora. Dans la terminologie WOPI, cette application est appelée « hôte ». Collabora interroge le CheckFileInfopoint de terminaison de l'hôte pour obtenir les informations et les autorisations relatives au fichier. L'hôte sait qui a ouvert le document et si un partage, un compte ou une stratégie de fichiers autorise les téléchargements.

• Nextcloud ou toute autre plateforme de fichiers intégrée : utilisez son paramètre de partage ou d’affichage sécurisé si votre version installée propose une option « Masquer le téléchargement » ou une politique équivalente. L’intégration peut traduire cette politique en autorisations WOPI. Consultez la réponse de l’hôte ou la documentation de la plateforme avant de supposer quels chemins d’exportation, d’impression, de copie ou de téléchargement direct sont bloqués.
• Votre hôte WOPI : mettez à jour le code qui génère la CheckFileInforéponse JSON. Calculez la restriction en fonction des permissions de l’utilisateur authentifié et de la politique de partage du fichier.
• L'administrateur du conteneur CODE n'ayant pas le contrôle de l'hôte doit demander à l'administrateur de l'hôte ou au développeur de l'intégration d'appliquer cette restriction. La modification du seul conteneur CODE peut masquer certains formats optionnels dans l'interface, mais ne fournit pas de politique d'autorisation WOPI par fichier.

La configuration source actuelle de Collabora décrit extra_export_formatsces options comme étant au niveau de l'interface : désactiver ces formats optionnels ne fait que les masquer visuellement. Ce paramètre ne sert pas à imposer des restrictions d'exportation côté serveur. Il est destiné à l'affichage du menu des formats et ne remplace pas les autorisations de l'hôte.

Définir les autorisations d'exportation dans un hôte WOPI personnalisé

1. Trouvez le gestionnaire de réponse CheckFileInfo

Repérez la route qui répond à GET /wopi/files/{id}la requête WOPI de Collabora. Vérifiez comment elle authentifie le jeton d'accès et l'associe à l'utilisateur et au fichier actuels. Ne vous fiez pas à un indicateur fourni par le navigateur, sauf ?disableExport=truesi l'hôte le valide par rapport à ses propres règles d'autorisation.

2. Déduire la décision de la politique de l'hôte

Utilisez les données de contrôle d'accès côté serveur pour déterminer si cette personne est autorisée à exporter ce fichier. Le propriétaire du fichier, un éditeur interne et un utilisateur consultant un lien public peuvent avoir des droits différents. Si la restriction concerne un partage spécifique, référez-vous à la politique de ce partage et non à une variable d'environnement globale qui affecte accidentellement tous les utilisateurs.

3. Retourner les champs booléens WOPI

Ajoutez les deux champs booléens à la réponse JSON. Il s'agit d'un fragment à intégrer à votre CheckFileInforéponse complète existante, et non d'un remplacement des propriétés de fichier et d'utilisateur requises.

{
  "BaseFileName": "budget.xlsx",
  "Size": 48123,
  "UserId": "viewer-42",
  "OwnerId": "team-7",
  "UserCanWrite": false,
  "HideExportOption": true,
  "DisableExport": true
}

Conservez les champs obligatoires et les indicateurs de capacité fournis par votre intégration. Utilisez des booléens JSON , trueet falsenon des chaînes de caractères comme ` "true"true` ou `false` "1". Lorsque l'exportation est autorisée, renvoyez `false` ou omettez les propriétés facultatives selon le comportement pris en charge par votre intégration et votre version de Collabora.

4. Bloquez l'enregistrement sous séparément si la politique l'exige.

L'exportation vers un format local et l'enregistrement d'une copie sur le serveur WOPI sont deux opérations distinctes. Si les utilisateurs ne doivent pas créer de copie « Enregistrer sous » via l'éditeur, il convient de désactiver UserCanNotWriteRelative: truecette option et de configurer le serveur pour qu'il rejette la requête d'écriture relative correspondante. Il ne faut pas supposer que cette option DisableExportbloque systématiquement toutes les copies ou tous les chemins d'enregistrement. De même, elle n'est à inclure DisablePrint: trueque lorsque l'impression est prise en charge par la politique d'exportation.

Appliquer le paramètre équivalent sur une plateforme intégrée

Lorsque Nextcloud gère les fichiers et les partages, la méthode la moins intrusive consiste à utiliser ses propres autorisations de masquage et de téléchargement ou d'affichage sécurisé, si elles sont disponibles pour ce type de partage et cette version. Le code source actuel de Nextcloud Richdocuments associe une politique de masquage et de téléchargement côté hôte aux champs de Collabora DisableExport, HideExportOptionainsi qu'aux restrictions d'impression et de copie. Les contrôles exacts offerts à un administrateur peuvent varier selon la version, l'édition et le type de partage de Nextcloud. Il est donc recommandé de vérifier le comportement du produit installé plutôt que d'intégrer un correctif WOPI personnalisé dans ses fichiers.

Si vous utilisez un autre hôte WOPI, implémentez les champs de sa réponse CheckFileInfo. Évitez de modifier la configuration du conteneur générée par Collabora pour ajouter des clés non documentées : la réponse WOPI communique les permissions par fichier. Après toute modification du code hôte, déployez-le selon la procédure de publication habituelle de l'application. Un redémarrage de Collabora ne modifie généralement pas une décision de permission générée par l'hôte ; fermez puis rouvrez le document pour obtenir une nouvelle réponse CheckFileInfo.

Vérifiez que la restriction fonctionne.

1. Ouvrez un document de test à l'aide d'un compte qui devrait être restreint.
2. Examinez la réponse CheckFileInfo de l'hôte WOPI dans les journaux d'application ou une trace de développement sécurisée. Vérifiez que les deux champs sont des booléens JSON définis sur « true » pour cette session.
3. Dans Collabora, vérifiez que l'option « Télécharger sous » est absente et testez l'action d'exportation correspondante. N'utilisez pas de fichier confidentiel réel lors de la vérification initiale.
4. Si l'option « Enregistrer sous » doit également être bloquée, vérifiez que la requête d'écriture relative côté hôte est bien rejetée. L'élément de menu peut rester visible même si l'hôte refuse l'opération.
5. Ouvrez un document distinct disposant des autorisations d'exportation. Vérifiez que la modification n'a pas désactivé par inadvertance l'exportation pour tous les utilisateurs ou fichiers.
6. Testez séparément le téléchargement direct depuis la plateforme de stockage. L'option d'exportation de Collabora ne révoque pas automatiquement l'autorisation de l'utilisateur à télécharger le fichier original depuis Nextcloud, ownCloud, WebDAV ou tout autre point de terminaison d'hébergement.

Si la commande reste visible, vérifiez que la réponse concerne bien le fichier et l'utilisateur testés, rouvrez le document pour créer une nouvelle session et assurez-vous que l'hôte envoie bien la commande HideExportOption. Si le bouton disparaît mais que l'exportation fonctionne toujours par un autre moyen, vérifiez que DisableExportl'action correspond bien à une exportation Collabora et non à un téléchargement proposé par l'hôte de stockage ou par un gestionnaire postMessage spécifique à l'intégration.

Limites de sécurité et recommandations pratiques

Ces paramètres contrôlent les opérations d'exportation et d'enregistrement prises en charge par Collabora ; ils ne peuvent empêcher un utilisateur ayant accès au document de prendre des captures d'écran, de photographier l'écran ou de copier manuellement les informations que l'application lui permet de visualiser. Collabora doit également recevoir le contenu du document pour l'afficher. Pour un contrôle des données plus strict, combinez les restrictions de l'éditeur avec l'autorisation de téléchargement de l'hébergeur de fichiers, la portée du jeton d'accès, la politique de partage, la journalisation des audits et tout filigrane ou mesure de prévention des pertes de données approuvé par l'organisation. Décrivez le résultat comme une restriction des chemins d'exportation autorisés, et non comme une impossibilité de copier le contenu visible.

Pour la plupart des installations CODE, utilisez DisableExportla HideExportOptionréponse WOPI CheckFileInfo générée par l'hôte, en la limitant à l'utilisateur et au document concernés. Imposer les téléchargements directs et l'enregistrement sous sur l'hôte, et vérifier les sessions restreintes et autorisées après le déploiement.

Références

• Manuel du SDK Collabora Online : WOPI CheckFileInfo et DisableExport
• Configuration source de Collabora Online : formats d'exportation supplémentaires
• Documentation Microsoft WOPI : CheckFileInfo
• Contrôleur WOPI Nextcloud Richdocuments