Mattermost

Características principales

• Ver y editar documentos de texto, hojas de cálculo y presentaciones usando la opción Abrir archivo en ONLYOFFICE.
• Gestionar derechos de acceso (Editar o Leer) desde el menú contextual con la opción Cambiar derechos de acceso.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto).
• Visor en vivo (Live Viewer): los usuarios con acceso de solo lectura pueden observar los cambios en tiempo real realizados por otros editores, incluidos sus cursores. Disponible solo para instalaciones en servidor, habilitado por defecto.
• Ver el historial de cambios del archivo.
• Temas modernos de interfaz Claro y Oscuro para los editores.
• Notificaciones para administradores cuando el editor ONLYOFFICE no está disponible (Habilitar notificaciones de estado en la Consola del sistema).
• Recarga automática del editor cuando se restaura la conexión.
• Soporte JWT para asegurar tu tráfico, de modo que nadie más que los usuarios con los derechos adecuados tenga acceso a tus documentos.

Formatos compatibles

• Para edición:
  • WORD: DOCM, DOCX, DOTM, DOTX
  • CELL: XLSB, XLSM, XLSX, XLTM, XLTX
  • SLIDE: POTM, POTX, PPSM, PPSX, PPTM, PPTX
  • PDF: PDF
• Para visualización:
  • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HML, 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, TSV, XLS, XLSB, 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, OXPS, PDF, XPS
  • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX

Novedades en la versión 2.3.0

Agregado

• Visor en vivo (Live Viewer): los usuarios con acceso de solo lectura ahora pueden ver los cambios en tiempo real de otros editores, incluidos sus cursores. Disponible solo para instalaciones en servidor, sin configuración adicional requerida.
• Soporte para temas de interfaz Moderno Claro y Moderno Oscuro (Pestaña View → Tema de interfaz → Moderno Claro / Moderno Oscuro).
• Notificaciones para administradores por desconexión del editor mediante la opción Habilitar notificaciones de estado en la Consola del sistema.
• Recarga automática del editor cuando se restaura la conexión.

El registro completo de cambios está disponible aquí.

Requisitos

• ONLYOFFICE Document Server v6.4.0 (versión servidor o versión en la nube) o superior

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde Mattermost como desde cualquier cliente final. Debe poder hacer POST directamente a Mattermost.

  Consulta la página oficial de documentación para aprender más sobre la instalación de ONLYOFFICE Docs.

  ONLYOFFICE Docs y Mattermost pueden instalarse en computadoras diferentes o en la misma máquina. Si usas una sola máquina, configura un puerto personalizado para Document Server.

• Mattermost v. 10.11.0 o superior
• Conector ONLYOFFICE v2.3.0 para Mattermost

Instalación del conector ONLYOFFICE para Mattermost

Para conectar Mattermost, sigue estos pasos:

1. Instala Node.js. Consulta la documentación de instalación para más detalles.
2. Instala Go. Consulta la documentación de instalación para más detalles. Los pasos varían según tu sistema operativo.
3. Instala make:

   sudo apt install make

4. Clona la rama del plugin:

   git clone https://github.com/ONLYOFFICE/onlyoffice-mattermost.git

5. Ve a la raíz del proyecto y actualiza los submódulos git:

   cd onlyoffice-mattermost/
   git submodule update --init --recursive

6. Inicia la compilación:

   make

Configuración del conector ONLYOFFICE para Mattermost

Ve a Consola del sistema → busca el plugin ONLYOFFICE mediante la búsqueda → Configurar. Habilita el plugin en el campo correspondiente y especifica los siguientes parámetros:

1. Dirección de ONLYOFFICE Docs — ingresa la URL donde está instalado ONLYOFFICE Docs (por ejemplo, https://documentserver).
   La dirección de ONLYOFFICE Docs debe ser accesible desde Mattermost, así como la dirección de Mattermost debe ser accesible desde ONLYOFFICE Docs.
2. Secreto JWT de Document Server — el secreto JWT del servidor de documentos usado para firmar los datos.
   A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. También debes habilitarlo en Mattermost: encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs y 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 Mattermost en este artículo.
3. Encabezado JWT — especifica el encabezado JWT.
   Si la protección JWT está habilitada, es necesario especificar un nombre de encabezado personalizado, ya que la política de seguridad de Mattermost bloquea los encabezados externos 'Authorization'. Este encabezado también debe especificarse en la configuración de firma de ONLYOFFICE Docs (más información aquí).
4. Prefijo JWT — especifica el prefijo JWT.
5. También puedes conectarte al servidor público de prueba de ONLYOFFICE Docs por un mes marcando la casilla Conexión al servidor demo de ONLYOFFICE Docs habilitada.
6. Formatos — selecciona los formatos de archivo que deben abrirse en ONLYOFFICE Docs. Todos los formatos están habilitados por defecto. Desmarca los formatos para deshabilitarlos.
7. Protección de archivos solo por el propietario — cuando está habilitado, solo los propietarios de archivos pueden proteger/desproteger archivos mediante la pestaña Protección. Cuando está deshabilitado, la protección de archivos está disponible para todos.
8. Habilitar plugins ONLYOFFICE — cuando está habilitado, los usuarios pueden acceder a los plugins en los editores. Cuando está deshabilitado, los plugins están ocultos.
9. Habilitar macros — cuando está habilitado, los usuarios pueden crear y ejecutar macros en los editores. Cuando está deshabilitado, toda la funcionalidad de macros está oculta.
10. Habilitar notificaciones de estado — habilita esta opción para recibir notificaciones de administrador cuando el editor ONLYOFFICE no esté disponible.

Cómo funciona

La interacción usuario-documento se realiza tanto en el lado del cliente como en el lado del servidor.

Las principales nociones usadas a lo largo de esta documentación se explican a continuación.

El lado cliente incluye:

• Administrador de documentos — la lista de documentos mostrada en el navegador del usuario donde puede seleccionar el documento necesario y realizar algunas acciones con él (dependiendo de los derechos otorgados, el usuario puede abrir el documento para verlo o editarlo, compartir el documento con otros usuarios).
• Editor de documentos — la interfaz para ver y editar documentos con todas las funciones de edición de documentos más conocidas disponibles, usada como medio entre el usuario y el servicio de edición de documentos.

El lado servidor incluye:

• Servicio de almacenamiento de documentos — el servicio del servidor que almacena todos los documentos disponibles para los usuarios con los derechos de acceso apropiados. Proporciona los IDs de documentos y enlaces a estos documentos al administrador de documentos que el usuario ve en el navegador.
• Servicio de edición de documentos — el servicio del servidor que permite realizar la visualización y edición de documentos (en caso de que el usuario tenga los derechos apropiados para hacerlo). La interfaz del editor de documentos se usa para acceder a todas las funciones del servicio de edición de documentos.
• Servicio de comandos de documentos — el servicio del servidor que permite realizar comandos adicionales con el servicio de edición de documentos.
• Servicio de conversión de documentos — el servicio del servidor que permite convertir el archivo de documento al formato Office Open XML apropiado (docx para documentos de texto, xlsx para hojas de cálculo y pptx para presentaciones) para su edición o descarga.
• Servicio de creación de documentos — el servicio del servidor que permite construir un documento fácilmente sin la necesidad de ejecutar un editor de procesamiento de documentos.

Ten en cuenta que ONLYOFFICE Document Server incluye el editor de documentos, servicio de edición de documentos, servicio de comandos de documentos, servicio de conversión de documentos y servicio de creación de documentos. El administrador de documentos y el servicio de almacenamiento de documentos están incluidos en el Community Server o deben ser implementados por los integradores de software que usan ONLYOFFICE Document Server en su propio servidor.

Habilitar JWT para la integración de ONLYOFFICE y Mattermost

Para proteger los documentos del acceso no autorizado, los editores ONLYOFFICE usan JSON Web Token (JWT). El token se añade 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 usa para firmar el token web JSON y validar el token al hacer la solicitud 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 y 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 en el 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 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 tengan 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 en el campo Clave secreta y guarda la configuración.

Visualización y edición de archivos

• Haz clic en el botón Más acciones junto a un archivo enviado en un chat de Mattermost.
• Elige la opción Abrir archivo en ONLYOFFICE en el menú contextual.
  

o

• Haz clic en el nombre del archivo.
• Aparecerá la ventana de vista previa del archivo. Para compartir el archivo con otros usuarios, haz clic en el botón Compartir. Para continuar con la edición, haz clic en el botón Editar en ONLYOFFICE.
  

El archivo se abrirá en el editor ONLYOFFICE correspondiente.

Los usuarios con acceso de solo lectura pueden usar el Visor en vivo (Live Viewer) para observar los cambios en tiempo real realizados por otros editores, incluidos sus cursores, sin cambiar al modo de edición. El Visor en vivo está disponible solo para instalaciones en servidor y está habilitado por defecto — no se requiere configuración adicional. Para más información sobre el Visor en vivo (Live Viewer), consulta la documentación API.

Cambiar derechos de acceso

Por defecto, el remitente tiene derechos de acceso de edición y el destinatario tiene derechos de acceso de lectura. Para cambiarlos, usa la opción Cambiar derechos de acceso disponible en el menú contextual del archivo. Esta opción está disponible solo para el remitente.

Para coeditar un documento, los usuarios autorizados deben abrir el mismo archivo juntos.

En un chat privado:

• Usa el menú desplegable en el campo Derechos de acceso para @usuario.
  

En un chat grupal para todos los miembros:

• Usa el menú desplegable en el campo Derechos de acceso predeterminados para miembros del chat.
  

En un chat grupal para un usuario específico:

• Usa el menú desplegable en la parte superior, elige el usuario requerido y haz clic en el botón Añadir a la derecha.
  
• El usuario aparecerá en la lista abajo. Cambia sus derechos de acceso mediante un menú desplegable a la derecha.
  

Ver historial de cambios

Todos los cambios en el archivo se enviarán como notificaciones que contienen el nombre de usuario.

Las notificaciones están disponibles en un hilo dedicado. Para abrir el hilo, haz clic en la flecha a la derecha del archivo.