ownCloud

Características principales

• Creación, edición y visualización de documentos, hojas de cálculo y presentaciones.
• Compartir archivos con diferentes permisos: visualización/edición, revisión, llenado de formularios y comentarios con menciones de usuario. También es posible restringir la descarga (en todos los editores) y la modificación de filtros (en hojas de cálculo). Compartir a través de enlaces públicos también está disponible.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), Control de cambios, comentarios y un chat incorporado.
• Coedición entre varias instancias federadas de ownCloud conectadas a un Servidor de documentos.
• Soporte JWT para asegurar tu tráfico de manera que nadie, aparte de los usuarios con los derechos adecuados, pueda acceder a tus documentos.

Formatos soportados

• Para edición: DOCM, DOCX, DOTM, DOTX, XLSB, XLSM, XLSX, XLTM, XLTX, POTM, POTX, PPSM, PPSX, PPTM, PPTX, PDF
• Para visualización:
  • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
  • CELL: CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSM, XLSX, XLT, XLTM, XLTX
  • SLIDE: DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
  • PDF: DJVU, DOCXF, OFORM, OXPS, PDF, XPS
  • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX
• Para convertir a formatos Office Open XML usando la opción Convertir con ONLYOFFICE: DOC, DOCM, DOT, DOTX, EPUB, HTM, HTML, ODP, ODT, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX.
  ODT, ODS y ODP también están disponibles para conversión instantánea. Después de habilitar la opción correspondiente en la configuración del administrador, los documentos en formato ODF se convierten inmediatamente en el editor y se abren después de hacer clic en ellos.

Novedades en la versión 9.10.1

Añadido

• Capacidad para insertar SVG en el editor.
• Soporte para visualización: vsdx, vssx, vstx, vsdm, vssm, vstm, odg, md.
• Configuración para habilitar la vista en vivo para documentos compartidos.
• Actualización automática de archivos cuando se restablece la conexión.

Cambiado

• Edición de archivos .xlsb.
• Eliminada la configuración customization_goback.
• Las opciones de tema ahora están limitadas a: sistema, claro y oscuro.
• Eliminada la configuración toolbarNoTabs.
• Corregido el problema al abrir el historial de versiones desde la barra lateral.
• Mostrar error al abrir la página de configuración existente.

El registro completo de cambios está disponible aquí.

Requisitos

• Servidor de Documentos de ONLYOFFICE v7.0 (servidor o versión en la nube) o posterior

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde ownCloud como desde cualquier cliente final. ONLYOFFICE Docs debe poder realizar POST a ownCloud directamente.

  A partir de la versión 4.3.0, ONLYOFFICE Docs y ownCloud pueden instalarse ya sea en diferentes computadoras o en la misma máquina. En caso de que elijas esta última opción, necesitarás configurar un puerto personalizado para ONLYOFFICE Docs, ya que por defecto tanto ONLYOFFICE Docs como ownCloud funcionan en el puerto 80.

  Por favor, consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
• ownCloud v10.0.0 y posteriores
• Conector de ONLYOFFICE v8.2.3 y posteriores para ownCloud

Instalación del conector de ONLYOFFICE para ownCloud

El administrador de ownCloud puede instalar la aplicación de integración desde el mercado de aplicaciones incorporado. Para hacerlo, sigue estos pasos:

1. Haz clic en el menú de hamburguesa en la parte superior izquierda.
2. Selecciona Market.
3. Ve a la categoría Herramientas.
4. Encuentra ONLYOFFICE en la lista de aplicaciones disponibles.
5. Haz clic en el botón Instalar.

Alternativamente, el administrador puede instalar la aplicación manualmente:

1. Obtén la aplicación de ONLYOFFICE para ownCloud. Hay varias formas de hacerlo:
   • Descarga la última versión firmada desde la tienda oficial de ownCloud.
   • O puedes descargar la última versión firmada desde la página de lanzamientos de la aplicación en GitHub. Por ejemplo:

     tar -xvzf vX.X.X.tar.gz

     Dónde vX.X.X es la versión necesaria del conector.

     Descomprime el archivo:

     tar -xvzf vX.X.X.tar.gz

     Renombra la carpeta a onlyoffice:

     mv onlyoffice-owncloud-X.X.X onlyoffice

   • O puedes clonar el código fuente de la aplicación y compilarlo tú mismo:

     git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice cd onlyoffice git submodule update --init --recursive

   ownCloud no funciona con aplicaciones no firmadas mostrando un mensaje de alerta, por lo que necesitarás usar ya sea la opción a o b para obtener la aplicación para tu entorno de producción.
2. Mueve la carpeta onlyoffice al directorio apps/ del servidor ownCloud (o algún otro directorio utilizado para conectar aplicaciones):

   cp -r /root/onlyoffice/ /var/www/owncloud/apps/

3. Ve al directorio apps/:

   cd /var/www/owncloud/apps

4. Cambia el propietario para actualizar la aplicación directamente desde la interfaz web de ownCloud:

   chown -R www-data:www-data onlyoffice

5. En ownCloud, ve a Configuración > Admin > Apps, haz clic en Mostrar aplicaciones deshabilitadas y haz clic en Habilitar para la aplicación ONLYOFFICE.

Configuración del conector de ONLYOFFICE para ownCloud

Para configurar las opciones de la aplicación ONLYOFFICE, ve a Configuración > Admin > Adicional.

En la sección Configuración del servidor, especifica las siguientes opciones:

• Dirección de ONLYOFFICE Docs - especifica la dirección URL donde está instalado el Servicio de Edición de Documentos. Este campo es obligatorio. Si instalas ONLYOFFICE Docs en un puerto personalizado, debes especificar el puerto, por ejemplo: http://127.0.0.1:8081/
  La dirección de ONLYOFFICE Docs debe ser accesible desde ownCloud, así como la dirección de ownCloud debe ser accesible desde ONLYOFFICE Docs.
• Desactivar verificación de certificado (inseguro) - marca esta casilla para desactivar la verificación del certificado y permitir que ownCloud establezca conexión con ONLYOFFICE Docs si estás usando un certificado autofirmado para tu ONLYOFFICE Docs (de lo contrario, ownCloud no validará un certificado autofirmado y no permitirá la conexión hacia/desde ONLYOFFICE Docs). Esta es una solución insegura, y recomendamos encarecidamente que reemplaces el certificado por uno emitido por alguna CA.
• Clave secreta - especifica la clave secreta utilizada para firmar los datos.
  A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Necesitas habilitarlo también en el lado de ownCloud: encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especifica la misma clave secreta en la configuración del conector. Para más detalles, consulta la sección Habilitar JWT para la integración de ONLYOFFICE y ownCloud de este artículo.
• La sección Configuración avanzada del servidor puede utilizarse si tu configuración de red no permite solicitudes entre el ownCloud instalado y ONLYOFFICE Docs usando las direcciones públicas. En este caso, especifica direcciones para solicitudes internas en los campos correspondientes:
  • En el campo Dirección de ONLYOFFICE Docs para solicitudes internas desde el servidor, especifica la dirección que se utiliza para acceder al Servicio de Edición de Documentos desde ownCloud.
  • En el campo Dirección del servidor para solicitudes internas desde ONLYOFFICE Docs, especifica la dirección que se utiliza para acceder a ownCloud desde el Servicio de Edición de Documentos.

Haz clic en el botón Guardar. Después de guardar la Configuración del servidor, aparecerán las secciones Configuración común, Configuración de personalización del editor y Plantillas comunes.

En la sección Configuración común, puedes especificar las siguientes opciones:

• Restringir el acceso a los editores a los siguientes grupos - marca esta casilla y selecciona grupos de usuarios que no podrán usar los editores de ONLYOFFICE en ownCloud.
• Usar ONLYOFFICE para generar una vista previa del documento - marca esta casilla para la generación de miniaturas a través de ONLYOFFICE. Ocupa algo de espacio en disco.
• Abrir archivo en la misma pestaña - marca esta casilla para abrir un archivo en la pestaña actual del navegador. Si esta opción no está marcada, un archivo se abrirá en una nueva pestaña del navegador.
• Mantener metadatos para cada versión una vez que el documento se edita permite mantener metadatos y mostrar cambios para cada versión del documento en el historial de versiones. Ocupa algo de espacio en disco. Puedes usar el botón Limpiar para eliminar los metadatos y liberar espacio en disco.
• La aplicación predeterminada para abrir el formato - te permite verificar los formatos para asociar con los editores de ONLYOFFICE. Los formatos docx, xlsx y pptx están seleccionados por defecto.
  La apertura en los editores de ONLYOFFICE se realizará solo para los formatos seleccionados en esta sección.
• Abrir el archivo para edición - permite a los administradores elegir los formatos de documento para editar a través de la conversión a formatos OOXML. Los formatos csv y txt están seleccionados por defecto.
  Importante Debido a las restricciones de formato, algunos datos pueden perderse al guardar en los formatos de la lista (csv, odp, ods, odt, rtf, txt).

  Después de habilitar la opción correspondiente, los documentos en los formatos especificados se convertirán inmediatamente y se abrirán en el editor de ONLYOFFICE para edición después de hacer clic en ellos y elegir el elemento del menú Abrir en ONLYOFFICE. Si un formato no está marcado, el archivo se abrirá para visualización.

En la sección Configuración de personalización del editor, puedes especificar las siguientes opciones:

• Mantener versiones intermedias al editar (forcesave) permite enviar todos los cambios al almacenamiento directamente al hacer clic en el botón Guardar en la interfaz de los editores de ONLYOFFICE si deseas prevenir la pérdida de datos. Cuando esta opción está deshabilitada, tus cambios se guardan automáticamente en la caché de los editores.
• Selecciona los elementos de la interfaz de los editores que deseas ocultar/mostrar (Chat, Encabezado más compacto, Comentarios y soporte, Ayuda, Encabezado de barra de herramientas monocromático).
• Modo de revisión para visualización permite establecer el modo de visualización de revisión de documentos por defecto:
  • Marcado - para resaltar los cambios propuestos,
  • Final - para mostrar con cambios aplicados,
  • Original - para mostrar el documento original sin cambios.

Después de realizar cambios en la Configuración común y/o Configuración de personalización del editor, haz clic en el botón Guardar ubicado abajo para guardar los cambios.

En la sección Plantillas comunes, puedes hacer clic en el icono y cargar plantillas docx, xlsx o pptx para crear nuevos documentos.

Puedes descargar o eliminar una plantilla de esta lista usando los iconos correspondientes.

Después de agregar plantillas en la configuración del administrador, los usuarios podrán elegir una plantilla al crear un nuevo documento usando el botón agregar en la interfaz de ownCloud o a través del menú Archivo > Crear nuevo en la interfaz de los editores de ONLYOFFICE.

Verificando la conexión

Puedes verificar la conexión a ONLYOFFICE Docs usando el siguiente comando occ:

occ onlyoffice:documentserver --check

Verás un texto, ya sea con información sobre la conexión exitosa o la causa del error.

Cómo funciona

La integración de ONLYOFFICE sigue la API documentada aquí.

1. Al crear un nuevo archivo, el usuario navega a una carpeta de documentos dentro de ownCloud y hace clic en el elemento Documento, Hoja de cálculo o Presentación en el menú nuevo (+).
2. El navegador invoca el método create en el controlador /lib/Controller/EditorController.php. Este método agrega una copia de un archivo desde la carpeta assets a la carpeta en la que el usuario se encuentra actualmente.
3. Al abrir un archivo existente, el usuario navega a él dentro de ownCloud y selecciona la opción de menú Abrir en ONLYOFFICE.
4. Se abre una nueva pestaña del navegador y se invoca el método index del controlador /lib/Controller/EditorController.php.
5. La aplicación prepara un objeto JSON con las siguientes propiedades:
   • url - la URL que ONLYOFFICE Docs usa para descargar el documento;
   • callbackUrl - la URL que ONLYOFFICE Docs usa para informar sobre el estado de la edición del documento;
   • documentServerUrl - la URL a la que el cliente necesita responder al Servidor de Documentos de ONLYOFFICE (puede establecerse en la página de configuración administrativa);
   • key - el UUID+Marca de tiempo modificada para instruir a ONLYOFFICE Docs si debe descargar el documento nuevamente o no.
6. ownCloud toma este objeto y construye una página a partir de la plantilla templates/editor.php, completando todos los valores necesarios para asegurar que el navegador del cliente cargue exitosamente el editor.
7. El navegador del cliente realiza una solicitud a la biblioteca JavaScript de ONLYOFFICE Docs y envía a ONLYOFFICE Docs la configuración de DocEditor con las propiedades anteriores.
8. Luego ONLYOFFICE Docs descarga el documento desde ownCloud y el usuario comienza a editar.
9. ONLYOFFICE Docs envía una solicitud POST a callbackUrl para informar a ownCloud que un usuario está editando el documento.
10. Cuando todos los usuarios y navegadores de clientes han terminado de editar, cierran la ventana de edición.
11. Después de 10 segundos de inactividad, ONLYOFFICE Docs envía un POST a callbackUrl informando a ownCloud que los clientes han terminado de editar el documento y lo han cerrado.
12. ownCloud descarga una nueva versión del documento, reemplazando la antigua.

Habilitar JWT para la integración de ONLYOFFICE y ownCloud

Para proteger los documentos del acceso no autorizado, los editores de ONLYOFFICE utilizan el JSON Web Token (JWT). El token se agrega en la configuración cuando se inicializa el Editor de Documentos y durante el intercambio de comandos entre los servicios internos de ONLYOFFICE Docs. La clave secreta se utiliza para firmar el token web JSON y validar el token al solicitar a ONLYOFFICE Docs.

A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Necesitas encontrar tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especifica la misma clave secreta en la configuración del conector.

Paso 1: Encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs

1. Abre el archivo local.json con cualquier editor de texto disponible.
   • Para Linux - /etc/onlyoffice/documentserver/local.json
   • Para Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Para Docker – ingresa al contenedor de ONLYOFFICE Docs usando el comando docker exec -it <containerID> bash y abre /etc/onlyoffice/documentserver/local.json

     Alternativamente, puedes usar el siguiente comando para encontrar la clave secreta predeterminada sin abrir local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   El archivo local.json debería verse así:

   { "services": { "CoAuthoring": { "token": { "enable": { "request": { "inbox": true, "outbox": true }, "browser": true } }, "secret": { "inbox": { "string": "yoursecret" }, "outbox": { "string": "yoursecret" }, "session": { "string": "yoursecret" } } } } }

2. El valor true está especificado en tres secciones. Significa que la validación del token está habilitada.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. La clave secreta generada automáticamente está especificada en tres secciones. Puedes reemplazar el valor secreto predeterminado con tu propia clave secreta. La clave secreta debe ser la misma en las tres secciones.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Si realizas cambios, guárdalos y reinicia los servicios para que los cambios de configuración surtan efecto.

   supervisorctl restart all

Paso 2: Especifica la misma clave secreta en la configuración del conector

En la configuración del conector, especifica la misma clave secreta en el campo Clave secreta y guarda la configuración.

Conectando al demo de ONLYOFFICE Docs

A partir de la versión 3.0.1 del conector de ONLYOFFICE, puedes probar los editores en línea de ONLYOFFICE dentro de ownCloud sin instalar ONLYOFFICE Docs.

Para activar la conexión, marca la casilla Conectar al servidor demo de ONLYOFFICE Docs y haz clic en el botón Guardar.

Instalando Docker y Docker Compose

1. Sigue esta instrucción para descargar e instalar Docker en tu computadora. Docker es un programa para automatizar el desarrollo y gestión de aplicaciones en entornos habilitados para contenedores.
2. Luego sigue esta instrucción para descargar e instalar el gestor de paquetes Docker Compose, que te permite describir y ejecutar aplicaciones de múltiples contenedores.

Instalando los servidores de ONLYOFFICE Docs y ownCloud

1. Descarga la última versión del repositorio docker-onlyoffice-owncloud. Para hacerlo, inserta la siguiente línea en la interfaz de línea de comandos:

   git clone --recursive https://github.com/ONLYOFFICE/docker-onlyoffice-owncloud

2. Una vez descargado el repositorio, ve a la carpeta docker-onlyoffice-owncloud:

   cd docker-onlyoffice-owncloud

3. Actualiza los submódulos en el repositorio:

   git submodule update --remote

4. Lanza Docker Compose:

   sudo docker-compose up -d

   Puede que necesites esperar un par de minutos hasta que todos los contenedores estén en funcionamiento después del comando anterior.

En la barra de direcciones del navegador, ingresa http://localhost para abrir la página de configuración de ownCloud y crear tu cuenta de administrador. Ingresa tu Usuario y Contraseña (por defecto, se usa admin para ambos campos).

Ahora puedes crear y editar documentos en ownCloud usando ONLYOFFICE Docs sin configurar ningún ajuste.

La configuración del servidor se especifica durante la implementación, pero puedes ajustar Configuración común, Configuración de personalización del editor y Plantillas comunes. Por favor, consulta la sección Configuración del conector de ONLYOFFICE para ownCloud para obtener más información sobre las configuraciones disponibles del conector.

Descargar los componentes necesarios

Primero, necesitas instalar el hipervisor para la máquina virtual. Elige entre VMware Workstation Pro o VirtualBox y sigue la documentación para obtener instrucciones detalladas de instalación.

Luego descarga ONLYOFFICE-ownCloud VM para el hipervisor que hayas elegido.

Importar el dispositivo virtual

Ahora abre el hipervisor e importa el dispositivo virtual ONLYOFFICE-ownCloud. Esta guía describe cómo hacerlo en ambas plataformas.

Instalar la aplicación

Una vez que la imagen se haya importado con éxito, inicia la Máquina Virtual. Pasa por el proceso de arranque a través del asistente de instalación, siguiendo los pasos a continuación.

1. Elige tu idioma e ingresa la ciudad más cercana.
   

   El asistente obtendrá la configuración regional del sistema por defecto, la zona horaria y la disposición del teclado.

   
2. Configura tu dominio y configuración de red. Por defecto, obtienes una dirección IP automáticamente. Alternativamente, puedes especificar tu dirección IP, máscara de red y puerta de enlace manualmente. Ingresa la dirección del servidor DNS preferido.
   
3. Selecciona tu configuración de dominio. La opción Gestionar usuarios y permisos directamente en este sistema está seleccionada por defecto. Permite crear un nuevo dominio en este sistema. Alternativamente, puedes conectarte al dominio UCS o Microsoft Active Directory existente.
   
4. Ingresa el nombre de tu empresa, dirección de correo electrónico del administrador para activar ONLYOFFICE (el archivo de licencia se enviará a esta dirección de correo electrónico), crea y confirma una nueva contraseña para tu cuenta de administrador.
   
5. Especifica el nombre de dominio completo para este sistema y la base LDAP:
   
6. Revisa tu configuración y asegúrate de que todo esté correctamente completado. Luego haz clic en el botón Configurar sistema.
   
7. Una vez que todo esté configurado, ONLYOFFICE está listo para comenzar en una plataforma UCS recién creada.
   
   
8. Ingresa tu dirección IP en la barra de direcciones del navegador y carga tu archivo ucs.license recibido por correo electrónico.
9. Para iniciar sesión en tu dispositivo de ONLYOFFICE Docs y ownCloud, haz clic en ownCloud en la sección Aplicaciones e ingresa el nombre de usuario y la contraseña predeterminados (owncloud, owncloud).

   Para iniciar sesión en tu Consola de Gestión Univention, haz clic en INICIAR SESIÓN en la parte superior o en Configuración del sistema y del dominio en la sección Administración e ingresa tu dirección de correo electrónico de administrador y la contraseña especificada durante el registro (ver paso 4).

   

Habilitar edición para ownCloud Web

Para habilitar el trabajo dentro de ownCloud Web, registra el conector en el config.json de ownCloud Web:

• Si instalaste ownCloud Web desde el mercado oficial, la ruta es

  owncloud-root-catalog

• Si lo compilaste desde el código fuente tú mismo usando esta instrucción, la ruta es

  owncloud-web-root-catalog/config/config.json

Para registrar el conector, usa estas líneas:

"external_apps": [ { "id": "onlyoffice", "path": "http(s):///custom/onlyoffice/js/web/onlyoffice.js" } ] 

Dependiendo de la configuración de tu servidor web, puedes eliminar el segmento index.php de la ruta URL.