Conecta Collabora Online a ownCloud Infinite Scale.

Utilice el servicio Collaboration de ownCloud Infinite Scale como puente WOPI entre la interfaz web y Collabora Online. Para una instalación nueva, la opción más segura es ocis_fullel ejemplo oficial modular de Docker Compose de ownCloud, que incluye Infinite Scale, Collaboration, Collabora y Traefik. Configure las URL públicas de Infinite Scale, Collabora y WOPI, utilice certificados TLS válidos y mantenga la coherencia de todos los secretos del servicio. No configure Infinite Scale como si fuera un servidor ownCloud clásico.

Esta distinción se verifica en la documentación actual de ownCloud: Infinite Scale integra suites ofimáticas a través de WOPI y su servicio de colaboración. Este servicio reemplaza al antiguo cs3org/wopiservidor externo en las versiones más recientes, por lo que los administradores que actualicen una implementación anterior deben seguir las instrucciones de migración correspondientes a su versión instalada.

1. Compruebe los requisitos de la versión y de la red.

Confirme la versión exacta de Infinite Scale antes de instalar nada. La documentación actual de ownCloud incluye el servicio de Colaboración en la documentación de desarrollo de la versión 9.0 e indica que debe iniciarse por separado cuando Infinite Scale se ejecuta en modo supervisado. El ejemplo completo de ownCloud también advierte que la configuración depende de versiones que incluyan el servicio de Colaboración y no funciona con las versiones de producción 5.x. Utilice la documentación y los archivos Compose que coincidan con su versión instalada; no copie un ejemplo de actualización continua en un sistema de producción antiguo sin comprobar la compatibilidad.

Para una implementación pública, planifique nombres de host separados como cloud.example.com, office.example.com, y wopi.example.com. El navegador debe poder acceder a las URL de la nube y de Collabora, mientras que Collabora debe poder acceder al punto final WOPI que expone Infinite Scale. El DNS, los firewalls y la confianza TLS deben funcionar en ambas direcciones. Un host accesible desde su computadora portátil pero no desde el contenedor de Collabora no es suficiente.

El ejemplo de implementación de ownCloud utiliza Traefik como proxy inverso y requiere un certificado SSL válido para la configuración del servidor. Su configuración de prueba local puede usar certificados autofirmados, pero las instalaciones públicas no deben deshabilitar silenciosamente la verificación de certificados. Decida qué nombres de host y certificados utilizará antes de configurar la pila.

2. Empiece con el ejemplo de Compose correspondiente de ownCloud.

1. Abra la guía oficial de ownCloud para la implementación modular completa de oCIS con WebOffice y el directorio de ejemplo ocis_full correspondiente . Para producción, seleccione una versión o etiqueta que coincida con su versión de Infinite Scale, en lugar de depender de la rama de actualización continua del repositorio.
2. Revise el .envarchivo de ejemplo. Configure OCIS_DOMAIN, COLLABORA_DOMAIN, y WOPISERVER_DOMAINcon los nombres de host que se resuelven a su servidor. El ejemplo habilita Collabora con COLLABORA=:collabora.yml; conserve esa configuración si Collabora es el editor de Office que desea utilizar.
3. Establezca credenciales de administrador seguras y privadas, y siga las instrucciones de TLS de producción del ejemplo. No deje las contraseñas de ejemplo. Si la versión del repositorio ha cambiado los nombres de las variables de entorno o la estructura de los archivos, utilice los archivos de esa misma versión etiquetada en lugar de combinar instrucciones de diferentes versiones.
4. Revise la configuración de Compose antes de iniciarla. Confirme que los servicios Collabora, Collaboration, Infinite Scale y proxy comparten la red y la configuración previstas. La guía de ownCloud advierte que, si Collaboration se ejecuta en un contenedor independiente, la configuración de Infinite Scale y los secretos generados deben compartirse con los demás servicios.

El ejemplo de implementación es una pila integrada, no una configuración universal para todas las instalaciones existentes. Si ya utiliza Infinite Scale con systemd, Kubernetes o un proxy inverso personalizado, mantenga ese modelo de implementación y configure el servicio de colaboración y el registro de aplicaciones siguiendo la documentación de esa versión, en lugar de implementar una segunda pila completa.

3. Conectar la colaboración con Collabora mediante WOPI.

La configuración principal identifica la URL del editor y la fuente WOPI accesible externamente. En la documentación actual del servicio, COLLABORATION_APP_NAMEes el nombre para mostrar de la aplicación, COLLABORATION_APP_PRODUCTidentifica el producto, COLLABORATION_APP_ADDRapunta a Collabora y COLLABORATION_WOPI_SRCes la URL que Collabora utiliza para leer y escribir archivos a través de Infinite Scale. Una configuración conceptual se ve así:

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

Utilice las URL públicas y el formato de variable que requiera su implementación. Si los servicios se comunican en una red interna de contenedores, la dirección interna puede ser apropiada para una configuración, mientras que la URL visible en el navegador corresponde a otra. No sustituya un nombre de host exclusivo del contenedor por un valor que Collabora deba resolver externamente.

El servicio de colaboración también requiere los valores de tiempo de ejecución de escala infinita OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, y MICRO_REGISTRY_ADDRESS. Estos deben coincidir con la instancia en ejecución; el ejemplo oficial de pila completa proporciona relaciones de servicio para su propia red Compose. No cree nuevos secretos para un solo servicio ni desactive las comprobaciones de prueba de clave de WOPI para evitar una discrepancia. Mantenga habilitada la verificación de certificados para certificados públicos de confianza; COLLABORATION_APP_INSECUREestá documentado solo como una opción para un certificado de aplicación WOPI autofirmado, no como una solución general para producción.

El Registro de aplicaciones controla qué aplicación de Office aparece para cada tipo MIME y cuál se abre por defecto. Si Collabora está en ejecución, pero los documentos no muestran la opción "Abrir con", compruebe la configuración del tipo MIME en el registro y su default_appvalor. El nombre utilizado debe coincidir con el nombre de la aplicación de Office configurada. ownCloud documenta esto como una configuración YAML; las variables de entorno no reemplazan la asignación del tipo MIME.

4. Iniciar, probar y diagnosticar la integración.

Con el ejemplo oficial de Compose, valide la configuración generada y, a continuación, inicie la pila desde su directorio de despliegue:

docker compose config
docker compose up -d

Si no utiliza el ejemplo de Compose, inicie primero los servicios de puerta de enlace, proveedor de aplicaciones y Collabora. En el modo supervisado, ownCloud documenta el inicio explícito de Collaboration con ocis collaboration server; no se inicia automáticamente. Asegúrese de que las variables de entorno necesarias estén completas en el proceso del servicio Collaboration antes de iniciarlo.

1. Abrir https://office.example.com/hosting/discoveryen un navegador. Un punto final accesible debería devolver el XML de descubrimiento de Collabora en lugar de un error de DNS, TLS o proxy.
2. Inicia sesión en Infinite Scale, abre un documento compatible y elige Collabora si la interfaz de usuario ofrece varias aplicaciones de Office. Prueba con un archivo existente y, si está habilitado en el Registro de aplicaciones, crea un documento nuevo.
3. Realiza una pequeña modificación, espera a que el indicador de guardado se estabilice, cierra el editor y vuelve a abrir el archivo para confirmar que el cambio se ha guardado.
4. Si el editor no se abre, revise los registros de Infinite Scale Collaboration y App Provider, los registros de Collabora y los registros del proxy inverso en la misma marca de tiempo. El mensaje "Host WOPI no autorizado" apunta a la configuración de confianza WOPI de Collabora; un error de devolución de llamada o un error TLS apunta a la accesibilidad de la URL o a la confianza del certificado; una opción de aplicación faltante apunta al Registro de aplicaciones.

La integración exitosa implica que el navegador carga el editor, la conexión WOPI llega a Infinite Scale y los cambios se conservan tras volver a abrir la aplicación. Los nombres exactos de los contenedores, el cableado de URL y la ubicación de los archivos de configuración dependen de la versión de Infinite Scale y del método de implementación. Consulte la documentación de ownCloud correspondiente a su versión para obtener más detalles, especialmente al migrar desde el servidor WOPI externo anterior.

Referencias: configuración del servicio ownCloud Collaboration , configuración del registro de aplicaciones de ownCloud y notas de la versión y de migración de Infinite Scale .