Exportación de archivos de bloques en Collabora CODE a través de WOPI

Para evitar que los usuarios exporten un documento abierto en Collabora Online CODE, haga que su host WOPI devuelva "DisableExport": trueen CheckFileInfola respuesta de ese documento. La documentación de integración de Collabora describe esto como la desactivación de la funcionalidad de exportación; cuando se configura, la opción de menú Descargar como también se oculta. HideExportOptionpor sí solo solo cambia la interfaz, por lo que no es el control adecuado cuando el objetivo es prohibir la exportación. Consulte las propiedades de respuesta extendidas CheckFileInfo de Collabora .

Utilice el permiso WOPI, no una configuración que solo esté disponible en el menú.

CODE es el componente de edición en una integración WOPI. Su servicio de almacenamiento o aplicación actúa como host WOPI y proporciona información por archivo cuando Collabora abre un documento. Esto convierte al host en el lugar adecuado para decidir si un usuario en particular puede exportar un archivo específico.

En el objeto JSON devuelto por el CheckFileInfopunto final del host, incluya la propiedad booleana:

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

Este es un fragmento ilustrativo, no una respuesta completa de CheckFileInfo. Conserve los demás campos obligatorios y las propiedades de integración existentes que su host ya devuelve. El valor de la clave debe ser un valor booleano JSON, no una cadena de texto "true". Establézcalo utilizando la misma decisión de autorización que su aplicación usa para el archivo y el usuario actual.

Por ejemplo, una organización podría permitir que el personal edite un libro de trabajo de presupuesto confidencial, impidiéndole al mismo tiempo usar las funciones de exportación de Collabora. Cuando el host de WOPI abre ese libro de trabajo para un miembro del personal, devuelve un valor específico DisableExport: true. Para una plantilla pública o un documento común, el host puede devolver un valor específico falsesegún su política. Un valor estático aplicado a cada documento solo es apropiado si todos los usuarios y documentos deben recibir la misma restricción.

Actualiza el host WOPI que sirve el archivo.

1. Identifique el punto final de integración. Busque la ruta del host que responde a CheckFileInfola solicitud WOPI de Collabora para el archivo. En Nextcloud, ownCloud u otro producto de almacenamiento, esto normalmente implica modificar la capa de integración o de políticas que genera la respuesta; editar la configuración global del contenedor de Collabora no sustituye los permisos por archivo del host.
2. Aplique la regla en el ámbito correcto. Obtenga el valor del usuario autenticado, la clasificación del archivo, los permisos de uso compartido u otra regla de su aplicación. Para una política simple que se aplique a todos los usuarios, devuelva verdadero para cada documento relevante. Evite depender de una preferencia del menú del navegador o de un valor proporcionado por el cliente.
3. Devuelve el valor booleano en CheckFileInfo. Asegúrate de que la respuesta sea JSON válido e incluya la propiedad en la respuesta que recibe Collabora. Un cambio de política a nivel de código puede requerir la implementación o el reinicio de la aplicación host de WOPI, según su marco de trabajo; CODE en sí mismo puede no requerir un cambio de configuración cuando el host proporciona el campo dinámicamente.
4. Vuelva a abrir el documento. Cierre la sesión de edición actual y abra el archivo nuevamente con la cuenta afectada. CheckFileInfo se consulta como parte del proceso de apertura del documento, por lo que una sesión ya abierta podría no reflejar un cambio en los permisos.

El archivo, la clase, la configuración o la interfaz administrativa exactos varían según el host WOPI y la versión del producto. La documentación de Collabora define el campo, pero no especifica una configuración universal para Nextcloud ni para aplicaciones de terceros. Si su host no ofrece restricciones de descarga, consulte la documentación administrativa del producto o implemente la política en la ruta de respuesta WOPI compatible.

¿Cuándo deberías también configurar HideExportOption?

Establézcalo HideExportOptionen truecuando desee ocultar el control Descargar como sin aplicar la prohibición de exportación. Para una restricción real, prefiera DisableExport: true; la guía de integración de Collabora indica que esto también implica el comportamiento de ocultación del menú. Devolver ambos campos como verdadero puede hacer explícita la intención en una integración, pero no debería ser necesario para el comportamiento documentado.

No confunda esto con las extra_export_formatsentradas en coolwsd.xml. La plantilla de configuración actual de Collabora indica explícitamente que deshabilitar esos formatos opcionales solo los oculta visualmente y no desactiva la exportación del lado del servidor. Estas opciones controlan qué formatos adicionales se ofrecen, no si un usuario está autorizado a exportar un documento. Revise la plantilla de configuración actual de Collabora Online antes de modificar la configuración global.

Lo que esta restricción protege —y lo que no—

DisableExportSe aplica a la funcionalidad de exportación de Collabora para la sesión. Es útil cuando los usuarios deben editar un archivo en el navegador, pero no deben usar las funciones de exportación o descarga del editor. Por sí sola, no elimina el acceso del usuario al archivo original en el servicio de almacenamiento. Si el servidor aún permite que el usuario descargue el archivo fuente en otra ubicación, la configuración de Collabora no cierra esa ruta.

Asimismo, un usuario con permisos para visualizar el contenido podría copiar información manualmente, tomar capturas de pantalla o utilizar otras funciones de la aplicación permitidas por su política. No describa esta configuración como una medida que impide la filtración total de datos ni que garantiza que el contenido no se pueda copiar. Para limitar el acceso al original, aplique también reglas de descarga y uso compartido en el host y la aplicación de almacenamiento de WOPI. Si su requisito es que el usuario no vea el contenido en absoluto, deniegue el acceso al documento en lugar de utilizar una opción de exportación.

También existe una distinción entre ocultar un elemento de la interfaz y deshabilitar una operación. La plantilla de configuración de Collabora establece esta distinción para sus ajustes opcionales de formato de exportación, mientras que el campo de respuesta WOPI representa la restricción a nivel de integración. La primera acción es útil para simplificar los menús; la segunda es la configuración destinada a bloquear las exportaciones a través de Collabora. Si una integración existente se comporta de manera diferente, verifique su versión de Collabora e inspeccione la respuesta real de CheckFileInfo en lugar de asumir que un producto host en particular asigna su propia casilla de verificación "deshabilitar descarga" a ambos campos.

Verifica la restricción con una cuenta de prueba.

1. Utilice una cuenta que no sea de administrador y que cumpla con la política de restricciones, y abra un documento de prueba en una sesión nueva.
2. Confirme que la opción "Descargar como" del editor ya no esté disponible. Si aún aparece, examine la respuesta CheckFileInfo generada para este usuario y archivo específicos; confirme que el campo sea booleano truey que se esté proporcionando la nueva respuesta.
3. Pruebe la acción de exportación a través de la interfaz habitual de Collabora. La política del host debería reflejarse en el comportamiento del editor. No dé por sentado que el control se aplica simplemente porque la opción del menú esté oculta.
4. Comprueba la aplicación de almacenamiento por separado: intenta su propia ruta de descarga solo si tu plan de pruebas lo permite. Si la descarga se realiza correctamente, significa que la política de acceso a los archivos de origen aún lo permite, incluso si Collabora bloquea las exportaciones.
5. Abra un documento para un usuario con permisos de exportación y confirme que su servidor devuelve el permiso previsto para ese caso. Esto permite detectar reglas que se aplicaron globalmente por error.

Para obtener detalles sobre la implementación, consulte la referencia de integración WOPI de Collabora y la plantilla de configuración del proyecto . El comportamiento compatible de CODE puede variar según las versiones y las integraciones con el host, por lo que debe validar la respuesta y el resultado en la versión que implemente. No se afirma que se haya probado una versión de host o una implementación de ejemplo en particular.