Nextcloud

Características principales

• Creación, edición y visualización de documentos, hojas de cálculo y presentaciones.
• Creación y llenado de formularios en línea.
• Compartir archivos con otros usuarios.
• Compartir archivos en un chat de Talk con arrastrar y soltar.
• Proteger documentos con marcas de agua.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), Control de cambios, comentarios y un chat integrado.
• Coedición entre varias instancias federadas de Nextcloud conectadas a un Servidor de documentos.
• Soporte JWT para asegurar el tráfico de modo que nadie, además de los usuarios con los derechos adecuados, pueda acceder a tus documentos.

Formatos soportados

• 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 edición:
  • WORD: DOCM, DOCX, DOTM, DOTX
  • CELL: XLSB, XLSM, XLSX, XLTM, XLTX
  • SLIDE: POTM, POTX, PPSM, PPSX, PPTM, PPTX
  • PDF: PDF

Novedades en la versión 9.12.0

Añadido

• Descripción del plugin y enlaces útiles añadidos en la configuración de administración

Cambiado

• Corregido el problema al abrir un enlace compartido cuando el acceso grupal a la aplicación está restringido
• Nextcloud v30 ya no es compatible
• Eliminados permisos extra al eliminar archivos
• Reemplazado el mensaje general Guardado con éxito por mensajes dedicados para cada sección de configuración
• Ahora se muestra un popup de advertencia cuando el secreto jwt está vacío y un mensaje de éxito de lo contrario
• Descargar todas las páginas del documento al convertir a tipos de imagen con el método Descargar como
• Extendidos los marcadores de posición de marcas de agua soportados
• Corregido el problema al abrir un enlace de carpeta compartida con contraseña

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 por DNS y accesible en red tanto desde Nextcloud como desde cualquier cliente final. ONLYOFFICE Docs debe poder realizar solicitudes POST a Nextcloud directamente.

  A partir de la versión 4.3.0, ONLYOFFICE Docs y Nextcloud pueden instalarse en diferentes computadoras o en la misma máquina. En caso de seleccionar esta última opción, necesitarás configurar un puerto personalizado para ONLYOFFICE Docs, ya que por defecto tanto ONLYOFFICE Docs como Nextcloud 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.
• Nextcloud v27
• Conector de ONLYOFFICE v8.2.4 y posteriores para Nextcloud

Instalación del conector de ONLYOFFICE para Nextcloud

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

1. Haz clic en el nombre de usuario y selecciona Aplicaciones.
2. Ve a la categoría Herramientas.
3. Encuentra ONLYOFFICE en la lista de aplicaciones disponibles.
4. Haz clic en el botón Descargar y habilitar.

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

1. Obtén la aplicación de integración de ONLYOFFICE para Nextcloud. Hay varias maneras de hacerlo:
   1. Descarga la última versión firmada desde la tienda oficial de Nextcloud.
   2. Descarga la última versión firmada desde la página de lanzamientos de la aplicación en GitHub. Por ejemplo:

      wget https://github.com/ONLYOFFICE/onlyoffice-nextcloud/archive/refs/tags/vX.X.X.tar.gz

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

      Descomprime el archivo, por ejemplo:

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

      Renombra la carpeta a onlyoffice, por ejemplo:

      mv onlyoffice-nextcloud-X.X.X onlyoffice

   3. Clona el código fuente de la aplicación y compílalo tú mismo:

      git clone https://github.com/ONLYOFFICE/onlyoffice-nextcloud.git onlyofficecd onlyofficegit submodule update --init --recursive

2. Mueve la carpeta onlyoffice al directorio apps/ del servidor de Nextcloud (o a otro directorio utilizado para conectar aplicaciones):

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

3. Ve al directorio apps/:

   cd /var/www/html/apps

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

   chown -R www-data:www-data onlyoffice

5. En Nextcloud, ve a Configuración > Aplicaciones > Aplicaciones deshabilitadas y haz clic en Habilitar para la aplicación ONLYOFFICE.

ONLYOFFICE Docs y Nextcloud pueden instalarse en diferentes computadoras o en la misma máquina. En caso de seleccionar esta última opción, necesitarás configurar un puerto personalizado para el Servidor de documentos, ya que por defecto tanto ONLYOFFICE Docs como Nextcloud funcionan en el puerto 80. También puedes usar el Servidor de documentos detrás de un proxy, por favor consulta este artículo para aprender cómo configurarlo.

Configurando el conector de ONLYOFFICE para Nextcloud

Para configurar los ajustes de la aplicación ONLYOFFICE, ve a Configuración > Administración > ONLYOFFICE.

En la sección de 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 Nextcloud, así como la dirección de Nextcloud debe ser accesible desde ONLYOFFICE Docs.
• Desactivar la verificación del certificado (inseguro) - marca esta casilla para desactivar la verificación del certificado y permitir que Nextcloud establezca conexión con ONLYOFFICE Docs si estás utilizando un certificado autofirmado para tu ONLYOFFICE Docs (de lo contrario, Nextcloud 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 una CA.
• Clave secreta - especifica el secreto utilizado para firmar los datos.
  A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Debes habilitarlo también en el lado de Nextcloud: 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 Nextcloud de este artículo.
• La sección de Configuración avanzada del servidor puede usarse si tu configuración de red no permite solicitudes entre el Nextcloud 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 Nextcloud.
  • En el campo Dirección del servidor para solicitudes internas desde ONLYOFFICE Docs, especifica la dirección que se utiliza para acceder a Nextcloud 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 de Configuración común, Configuración de personalización del editor, Plantillas comunes y Configuración de vista segura.

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

• Permitir a los siguientes grupos acceder a los editores - marca esta casilla y selecciona los grupos de usuarios que podrán usar los editores de ONLYOFFICE en Nextcloud.
• 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.
• Proporcionar permisos avanzados de documentos usando ONLYOFFICE Docs - marca esta casilla para poder especificar permisos adicionales en la pestaña Avanzado del panel de documentos: Revisar y comentar para documentos, Filtro personalizado para hojas de cálculo. Para más detalles, consulta la sección Comenzar a usar ONLYOFFICE Docs dentro de Nextcloud de este artículo.
• Mantener metadatos para cada versión una vez que el documento se edita Esta función permite que los metadatos se conserven y los cambios se muestren 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 - permite especificar qué formatos 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 convirtiéndolos a formatos OOXML. Los formatos csv y txt están seleccionados por defecto.
  Debido a las restricciones de formato, algunos datos podrían 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. Si un formato no está marcado, el archivo se abrirá para visualización.

En la sección de 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 los cambios aplicados,
  • Original - para mostrar el documento original sin cambios.
• Tema predeterminado del editor permite establecer el tema predeterminado: Claro, Clásico Claro o Oscuro.

En la sección de Plantillas comunes, puedes hacer clic en el icono y subir 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 añadir plantillas en la configuración de administración, los usuarios podrán elegir una plantilla al crear un nuevo documento usando el botón añadir en la interfaz de Nextcloud o a través del menú Archivo > Crear nuevo en la interfaz de los editores de ONLYOFFICE.

En la sección de Seguridad, puedes proteger documentos incrustando una marca de agua, así como deshabilitar o habilitar la ejecución de macros.

Después de realizar cambios en la configuración de la aplicación, haz clic en el botón Guardar ubicado debajo de cada sección para guardar los cambios.

Comprobando la conexión

Puedes comprobar 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 utiliza la API documentada aquí.

1. Al crear un nuevo archivo, el usuario navega a una carpeta de documentos dentro de Nextcloud 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 añade una copia de un archivo de la carpeta de activos a la carpeta en la que el usuario se encuentra actualmente.
3. Al abrir un archivo existente, el usuario navega hasta él dentro de Nextcloud 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 utiliza para descargar el documento;
   • callbackUrl - la URL que ONLYOFFICE Docs utiliza para informar sobre el estado de la edición del documento;
   • documentServerUrl - la URL que el cliente necesita usar para comunicarse con el 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. Nextcloud toma este objeto y construye una página desde la plantilla templates/editor.php, llenando todos esos valores para que el navegador del cliente pueda cargar 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 de Nextcloud y el usuario comienza a editar.
9. ONLYOFFICE Docs envía una solicitud POST a callbackUrl para informar a Nextcloud que un usuario está editando el documento.
10. Cuando todos los usuarios y navegadores de los clientes o navegadores de los usuarios 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 Nextcloud que los clientes han terminado de editar el documento y lo han cerrado.
12. Nextcloud descarga una nueva versión del documento, reemplazando la antigua.

Habilitar JWT para la integración de ONLYOFFICE y Nextcloud

Para proteger los documentos del acceso no autorizado, los editores de ONLYOFFICE utilizan el token JSON Web (JWT). El token se añade a 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. Debes encontrar tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especificar 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 – entra 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. Esto significa que la validación de tokens 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.
   • Para Linux:

     sudo supervisorctl restart all

   • Para Docker:

     docker exec <containerID> supervisorctl restart all

     o reinicia todo el contenedor:

     docker restart <containerID>

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

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

Conectando a la demo de ONLYOFFICE Docs

A partir de la versión 3.0.0 del conector de ONLYOFFICE, puedes probar los editores en línea de ONLYOFFICE dentro de Nextcloud 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.

Instalación de 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.

Instalación de los servidores ONLYOFFICE Docs y Nextcloud

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

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

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

   cd docker-onlyoffice-nextcloud

3. Inicia Docker Compose:

   sudo docker-compose up -d

   Es posible que debas 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 Nextcloud y crear tu cuenta de administrador. Especifica tu Usuario y Contraseña.

Una vez que hayas terminado con el asistente, ve a la carpeta docker-onlyoffice-nextcloud y ejecuta el script de configuración:

sudo bash set_configuration.sh

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

Los ajustes del servidor se especifican durante el despliegue, pero puedes ajustar Configuraciones comunes, Configuraciones de personalización del editor, Plantillas comunes y Configuraciones de vista segura. Por favor, consulta la sección Configuración del conector ONLYOFFICE para Nextcloud para obtener más información sobre los ajustes 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-Nextcloud VM para el hipervisor que hayas elegido.

Importar la aplicación virtual

Ahora abre el hipervisor e importa la aplicación virtual ONLYOFFICE-Nextcloud. Esta guía describe cómo hacerlo en ambas plataformas.

Instalar la aplicación

Una vez que la imagen se haya importado correctamente, 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 ajustes 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 tus ajustes 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 existente o al dominio de Microsoft Active Directory.
   
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 completamente calificado para este sistema y la base LDAP:
   
6. Revisa tus configuraciones 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 aplicación ONLYOFFICE Docs y Nextcloud, haz clic en Nextcloud en la sección Aplicaciones.

   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.

   Ingresa Administrador en el campo de inicio de sesión y la contraseña especificada durante el registro (ver paso 4).

   

Iniciar ONLYOFFICE Desktop Editors

Para conectar Desktop Editors a tu servidor Nextcloud, realiza las siguientes acciones:

1. Cambia a la sección Conectar a la nube en el panel lateral izquierdo.
2. Haz clic en el botón del servicio en la nube Nextcloud. Alternativamente, puedes usar el enlace Conectar ahora en la parte inferior.
   
3. Si presionaste el botón del servicio Nextcloud, se abrirá la ventana Conectar a la oficina en la nube con Nextcloud seleccionado. Si usaste el enlace Conectar ahora, elige el almacenamiento en la nube Nextcloud de la lista desplegable.
   • en el campo URL de la oficina en la nube, ingresa el nombre de dominio o la dirección IP de tu servidor Nextcloud. Cuando estés listo, haz clic en el botón Conectar ahora.
     

   • La página de Inicio de sesión de Nextcloud se abrirá en una nueva pestaña de la interfaz de Desktop Editors.

     • Especifica tu Nombre de usuario o correo electrónico y la Contraseña que usas para acceder a tu cuenta de Nextcloud,
     • Haz clic en el botón Iniciar sesión.
     

Se abrirá la sección Archivos de tu cuenta de Nextcloud. Ahora puedes editar tus archivos existentes y crear nuevos, compartir tus documentos y colaborar en ellos con usuarios de Nextcloud usando los editores de ONLYOFFICE.