Corrige la comprobación de host WOPI de CODE haciendo coincidir el origen del host.

Cuando Collabora Online CODE informa "Host WOPI no autorizado", agregue el host de almacenamiento de archivos real (generalmente su origen de Nextcloud) a la lista de hosts WOPI permitidos de CODE. El host debe coincidir con el origen que CODE recibe en la solicitud WOPI, no con la URL pública del servidor Collabora. En Docker, esto se suele configurar con la aliasgroup1variable de entorno.

Cuadro de diálogo de advertencia del editor de documentos que muestra "Host WOPI no autorizado. Inténtelo de nuevo más tarde".
Esta advertencia identifica la comprobación de autorización del host WOPI que falló.

¿Qué CÓDIGO está rechazando?

WOPI significa Interfaz de Plataforma Abierta para Aplicaciones Web, el protocolo que usa un servidor de oficina para abrir y guardar archivos a través de una plataforma de almacenamiento. El host WOPI es esa plataforma de almacenamiento, como Nextcloud. CODE compara el host especificado en la solicitud WOPI con los hosts en los que confía. Si la solicitud especifica un nombre, cloud.example.compero CODE está configurado para confiar solo en office.example.com, el editor puede rechazar la sesión antes de que se abra.

En una configuración autoalojada, el nombre de host en la solicitud puede ser un nombre interno de Docker, en lugar nextclouddel nombre de host visible en el navegador. Un proxy inverso, un puerto diferente o URL públicas e internas distintas también pueden provocar que el origen varíe. Configure el nombre que realmente utiliza la solicitud, no el que parece ser el nombre del servidor principal.

Encuentra el host CODE está rechazando

  1. Reproduce el fallo una vez y, a continuación, inspecciona el registro del contenedor CODE en ese momento. Con Docker Compose, ejecuta docker compose logs --since=10m collabora, reemplazando collaboracon el nombre de tu servicio.
  2. Busque un mensaje como este No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Anote el host de destino que aparece entre corchetes. No copie ni comparta una URL WOPI completa: puede contener un token de acceso de corta duración.
  3. Compara ese nombre de host y esquema con la URL que tu integración de almacenamiento anuncia a CODE. En Nextcloud, la guía de solución de problemas recomienda verificar que la URL configurada sea la URL de Nextcloud y que CODE pueda acceder a ella. Comprueba el WOPISrchost, si está disponible en los registros de tu integración, manteniendo en privado cualquier token de cadena de consulta.
Ventana de terminal que muestra un patrón de registro ilustrativo: No se encontraron hosts WOPI aceptables que coincidan con el host de destino [cloud.example.com] en la configuración.
El host de destino entre corchetes es el valor que se comparará con los hosts WOPI configurados de CODE; este es un patrón de registro ilustrativo.

Permitir el origen correcto en el CÓDIGO

Para la imagen oficial de Docker de CODE, configúrela aliasgroup1con el origen WOPI de confianza exacto. Para una única instalación de Nextcloud, un servicio Compose puede incluir:

services:
  collabora:
    image: collabora/code
    environment:
      aliasgroup1: "https://cloud.example.com:443"

Sustituye el ejemplo por tu host Nextcloud real, así como por el esquema y el puerto que utiliza la solicitud WOPI. Mantén la etiqueta de imagen, la configuración del administrador, la red y otras opciones de servicio existentes en tu archivo Compose. El ejemplo utiliza un origen HTTPS con el puerto 443; una implementación diferente podría usar otro puerto o un origen interno.

Editor YAML que muestra aliasgroup1 configurado en el origen de ejemplo de Nextcloud https://cloud.example.com:443.
Para un único origen de Nextcloud, el aliasgroup1 de Docker de CODE debe coincidir con el host utilizado en la solicitud WOPI.

Después de editar el archivo Compose, vuelva a crear el contenedor CODE para que reciba el entorno actualizado:

docker compose up -d --force-recreate collabora

Utilice el nombre real de su servicio Compose en lugar de collabora. Un simple reinicio podría no cargar los valores modificados del entorno del contenedor; recrear el servicio aplica la configuración actualizada. Si configura CODE mediante su archivo XML, consulte los storage.wopigrupos de alias en la configuración efectiva. El manual oficial del SDK de Collabora documenta los grupos de alias de Docker y los alias de host de WOPI; siga la sintaxis correspondiente a la versión de CODE que utilice.

Mantén separadas las dos listas de permitidos.

Collabora y Nextcloud pueden imponer restricciones relacionadas con WOPI, pero responden a preguntas diferentes:

ConfiguraciónLo que compruebaCorrección típica
Lista de permisos del host WOPI de CÓDIGO ( aliasgroup1)¿Qué nombre de host de almacenamiento acepta CODE en una solicitud WOPI?Permitir el origen real de Nextcloud enviado a CODE
Nextcloud “Lista de permisos para solicitudes WOPI”¿Qué direcciones IP de origen pueden enviar solicitudes WOPI a Nextcloud?Permitir la dirección que Nextcloud ve para el contenedor o proxy CODE
Página ilustrativa de configuración de administración de Nextcloud que muestra la sección de Office y un campo de entrada para la "Lista de permisos para solicitudes WOPI".
Esta configuración independiente de Nextcloud restringe las direcciones de origen autorizadas para enviar solicitudes WOPI; no se trata de la lista de nombres de host WOPI de confianza de CODE.

Modificar la lista de direcciones IP permitidas de Nextcloud no solucionará el problema de CODE al rechazar un nombre de host. Del mismo modo, añadir un nombre de host a CODE no autoriza la dirección IP de origen de CODE en Nextcloud. La documentación de Nextcloud recomienda restringir las solicitudes WOPI a las direcciones IP del servidor Collabora; utilice la dirección que observa Nextcloud, que puede variar cuando intervienen contenedores o un proxy inverso.

Comprobaciones rápidas antes de cerrar el incidente.

  • Target dice cloud.example.com: permitir ese host de Nextcloud y el origen apropiado en CODE.
  • Target dice nextcloud: CODE probablemente está recibiendo un nombre de host de red Docker; decida si ese origen interno es el previsto, luego configure el host de confianza correspondiente y asegúrese de la accesibilidad DNS/de red.
  • El objetivo coincide, pero persiste el mismo rechazo: confirme que la variable editada pertenece al servicio CODE en ejecución, que Compose recreó el contenedor y que ninguna configuración de entorno o XML posterior anula la configuración.
  • El registro muestra un error de DNS, TLS, tiempo de espera o CheckFileInfo: es posible que la verificación de autorización del host ahora sea exitosa. Investigue la resolución de nombres, la confianza del certificado, el enrutamiento o la respuesta de información de archivos de la integración de almacenamiento en lugar de ampliar la lista de hosts de WOPI.
  • Nextcloud informa de una dirección de solicitud no autorizada: revise la lista de direcciones IP de origen permitidas de Nextcloud y la dirección IP del cliente que realmente detecta.

No intente solucionar un desajuste confiando en todos los hosts ni utilizando un comodín sin restricciones en un entorno de producción. Limite la lista de permitidos a los orígenes de almacenamiento conocidos. Si desea utilizar varios hosts de almacenamiento, configure los grupos de alias documentados para su versión de CODE instalada en lugar de intentar adivinar el comportamiento del comodín.

Verificar la solución

Abra un documento mediante la misma integración de Nextcloud que falló. A continuación, revise los registros de CODE actualizados: el rechazo "No se encontraron hosts WOPI aceptables" debería haber desaparecido. Confirme que el documento se carga y se puede guardar; si aparece un nuevo error, utilice su mensaje para identificar el siguiente paso. Para las comprobaciones de los dos hosts y el flujo de solución de problemas de Nextcloud, consulte la sección de solución de problemas y configuración de Nextcloud Office . Para los grupos de alias de Docker de CODE, consulte el manual de Collabora Online SDK 25.04 ; utilice la documentación que corresponda a su versión instalada si su configuración difiere.

Dejar un comentario

Restaurar la configuración de Collabora CODE sin perder los cambios de implementación.

Restaurar la configuración de Collabora CODE sin perder los cambios de implementación.

Realice una copia de seguridad de coolwsd.xml y sus fuentes de implementación, restáurelas de forma segura y verifique el CÓDIGO antes de que los usuarios vuelvan a editarlo.

Corrige la comprobación de host WOPI de CODE haciendo coincidir el origen del host.

Corrige la comprobación de host WOPI de CODE haciendo coincidir el origen del host.

Permita el origen exacto de Nextcloud u otro WOPI en CODE, luego verifique la lista de hosts permitidos activa y distíngala de la restricción de IP de origen de Nextcloud.

Solucionar el error "Bueno, esto es vergonzoso" de Collabora

Solucionar el error "Bueno, esto es vergonzoso" de Collabora

Analiza las conexiones del navegador, WOPI y WebSocket de Collabora para descubrir por qué no se abre un documento y, a continuación, aplica la solución que coincida con la configuración de tu Nextcloud.

Ejecuta Collabora Online en nodos de Kubernetes.

Ejecuta Collabora Online en nodos de Kubernetes.

Implementa réplicas de Collabora CODE con Helm, mantén cada documento en un pod mediante la afinidad WOPI y verifica el acceso, la ubicación de los nodos y la edición en Nextcloud.

Restablecer la conexión WebSocket de Collabora a través del proxy

Restablecer la conexión WebSocket de Collabora a través del proxy

Rastrea un error en el protocolo de enlace de socket desde el navegador hasta coolwsd, y luego compara la ruta del proxy inverso con tu versión de Collabora, incluyendo el cambio de Apache CODE 26.04.

Solucione los errores de WOPI Proof comprobando las claves, el descubrimiento y las URL.

Solucione los errores de WOPI Proof comprobando las claves, el descubrimiento y las URL.

Detecta fallos en la prueba WOPI de Collabora debidos a claves que no coinciden, datos de descubrimiento obsoletos, desfase horario o cambios en la URL del proxy, sin debilitar la validación.

Solucionar un problema con el menú desplegable de tamaño de fuente de Collabora Online.

Solucionar un problema con el menú desplegable de tamaño de fuente de Collabora Online.

Restablezca el zoom del navegador, pruebe una sesión limpia e identifique cuándo un menú de tamaño con formato incorrecto necesita una actualización del servidor de Collabora.

Conecta Nextcloud a un contenedor Collabora CODE autohospedado.

Conecta Nextcloud a un contenedor Collabora CODE autohospedado.

Implemente Collabora CODE con Docker, conéctelo de forma segura a Nextcloud Office y verifique la edición de documentos con comprobaciones prácticas de WOPI y proxy.

Rastrea los fallos de conexión de Collabora con los registros de coolwsd.

Rastrea los fallos de conexión de Collabora con los registros de coolwsd.

Activa temporalmente el modo de depuración de coolwsd, captura un intento de apertura fallido y utiliza la secuencia de registros para separar los problemas de WebSocket, WOPI, proxy y contenedor.

Establezca una contraseña segura para la consola de administración de Collabora.

Establezca una contraseña segura para la consola de administración de Collabora.

Configure el inicio de sesión de administrador de Collabora Online para Docker o Linux, reinicie el servicio correspondiente y verifique la nueva contraseña sin exponerla.