Mattermost

Características principales

• Ver y editar documentos de texto, hojas de cálculo y presentaciones mediante 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).
• Ver el historial de cambios del archivo.
• Soporte JWT para asegurar el tráfico de modo que nadie más que los usuarios con los derechos adecuados tenga acceso a tus documentos.

Formatos soportados

• Para edición y visualización: DOCX, PPTX, XLSX
• Solo para visualización: XLS, XLSX, CSV, XLSM, XLT, XLTM, ODS, FODS, OTS, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP, DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF

Novedades en la versión 2.0.0

Añadido

• Soporte para nuevos formatos de documentos
• Conversión al formato OOXML
• Funcionalidad de conversión manual de XML a documento/hoja de cálculo
• Capacidad para convertir documentos protegidos
• Nueva opción de carga para crear documentos
• Soporte para servidor de demostración
• Soporte para temas Onyx e Indigo (incluido soporte para editores)

Cambiado

• Arquitectura del servidor refactorizada para utilizar módulos FX
• Reemplazado el servicio de formatos por el submódulo de formatos
• Introducido un nuevo submódulo de plantillas de documentos vacíos
• Actualizados y modernizados los iconos de documentos
• Mejorada la generación de claves de fragmentos para los editores de documentos
• Mejorada la validación de la configuración
• Actualizados los estilos de la ventana de permisos

Corregido

• Optimización general del rendimiento y corrección de errores

El registro completo de cambios está disponible aquí.

Requisitos

• Servidor de documentos de ONLYOFFICE v6.4.0 (servidor o versión en nube) o posterior

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble por DNS y accesible en red tanto desde Mattermost como desde cualquier cliente final. Debe poder realizar solicitudes POST a Mattermost directamente.

  Por favor, consulta la página de documentación oficial para obtener más información sobre cómo instalar ONLYOFFICE Docs.

  ONLYOFFICE Docs y Mattermost pueden instalarse en diferentes computadoras o en la misma máquina. Si usas una máquina, configura un puerto personalizado para el Servidor de documentos.

• Mattermost v. 5.37.2 o posterior
• Conector de ONLYOFFICE v1.1.3 para Mattermost

Instalación del conector de ONLYOFFICE para Mattermost

Para conectar Mattermost, sigue estos pasos:

1. Obtén la aplicación de integración de ONLYOFFICE para Mattermost. Hay varias formas de hacerlo:
   • Descarga la última versión desde la página de lanzamientos de la aplicación en GitHub.
   • Clona el código fuente de la aplicación y compílalo tú mismo:
     1. Clona la rama principal.
     2. Ve a la raíz del proyecto.
     3. Instala las dependencias:

        npm install --legacy-peer-deps

        Para construir el plugin, necesitas tener Node.js v.15.14.0 instalado en tu máquina.
     4. Ejecuta el siguiente comando:

        make dist

2. Ve a (tu_host_de_mattermost)/admin_console/plugins/plugin_management
3. Elige el archivo tar.gz descargado o el plugin compilado de tu carpeta dist y presiona Subir.

Configuración del conector de 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 del servicio de edición de documentos - ingresa la dirección 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. Clave secreta - el secreto JWT del servidor de documentos 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. Necesitas habilitarlo también en el lado de Mattermost: 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 Mattermost de 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 se puede encontrar aquí).
4. Prefijo JWT - especifica el prefijo JWT.

Cómo funciona

La interacción entre el usuario y el document se realiza tanto en el lado del cliente como en el lado del servidor.

Las nociones principales utilizadas a lo largo de la documentación actual se explican a continuación.

El lado del cliente incluye:

• Gestor de documentos - la lista de documentos mostrada en el navegador del usuario donde el usuario puede seleccionar el documento necesario y realizar algunas acciones con él (dependiendo de los derechos proporcionados, el usuario puede abrir el documento para verlo o editarlo, compartir el documento con otros usuarios).
• Editor de documentos - la interfaz de visualización y edición de documentos con todas las características de edición de documentos más conocidas disponibles, utilizada como medio entre el usuario y el servicio de edición de documentos.

El lado del 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 ID de documentos o identificadores de documentos y enlaces a estos documentos al gestor 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 utiliza para acceder a todas las características 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 en el formato apropiado de Office Open XML (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 crear un documento fácilmente sin la necesidad de ejecutar un editor de procesamiento de documentos.

Por favor, ten en cuenta que el Servidor de documentos de ONLYOFFICE 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 gestor de documentos y el servicio de almacenamiento de documentos están incluidos en el Servidor Comunitario o deben ser implementados por los integradores de software que utilizan el Servidor de documentos de ONLYOFFICE en su propio servidor.

Habilitar JWT para la integración de ONLYOFFICE y Mattermost

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. 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 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.

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 del menú contextual.
  

o

• Haz clic en el nombre del archivo.
• La ventana de vista previa del archivo aparecerá. 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 correspondiente de ONLYOFFICE.

Cambio de derechos de acceso

El remitente tiene derechos de acceso de edición y el destinatario tiene derechos de acceso de lectura por defecto. 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 los 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 Agregar a la derecha.
  
• El usuario aparecerá en la lista a continuación. Cambia sus derechos de acceso a través de un menú desplegable a la derecha.
  

Visualización del 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.