SuiteCRM

Requisitos

• Servidor de documentos de ONLYOFFICE v7.1 (servidor) o posterior

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde SuiteCRM como desde cualquier cliente final. Debe ser capaz de realizar POST directamente a SuiteCRM.

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

Instalación del módulo de integración de ONLYOFFICE para SuiteCRM

Cómo funciona

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

A continuación se explica los términos clave utilizados a lo largo de esta documentació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 IDs de los 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 del 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.

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.

Configuración de JWT para la integración de ONLYOFFICE y SuiteCRM

JWT o JSON Web Token es una cadena enviada del cliente al servidor dentro de la solicitud HTTP para validar la autenticidad del cliente. JWT se guarda solo en el lado del cliente, por lo que la transmisión entre las partes está protegida y firmada digitalmente.

El token se genera utilizando el estándar JWT (JSON Web Tokens). Los tokens son firmados por la clave del servidor, por lo que el cliente puede verificar que el token es legítimo.

ONLYOFFICE Docs valida el token. Los datos del payload se consideran válidos y se utilizan en lugar de los datos correspondientes de los parámetros principales. Si el token es inválido, el comando no se ejecuta. Para obtener más información, por favor lee la guía de seguridad de la API.

En ONLYOFFICE Docs, JWT está habilitado por defecto a partir de la versión 7.2.

Sigue estos pasos para configurarlo manualmente si es necesario:

1. Ve a Admin > ONLYOFFICE > Configuración de ONLYOFFICE.
   
2. Ingresa los valores en los siguientes campos:
   • Dirección del Servicio de Edición de Documentos: Especifica la dirección URL donde está instalado ONLYOFFICE Docs (por ejemplo, https://documentserver).
   • Clave secreta (dejar en blanco para desactivar): La clave secreta se genera automáticamente para restringir el acceso a ONLYOFFICE Docs. Si deseas especificar tu propia clave secreta en este campo, también especifica la misma clave secreta en el archivo de configuración de ONLYOFFICE Docs para habilitar la validación.
   • Encabezado de autorización (dejar en blanco para usar el encabezado predeterminado): El encabezado JWT estándar utilizado en ONLYOFFICE es Authorization. En caso de que este encabezado entre en conflicto con tu configuración, puedes cambiar el encabezado a uno personalizado.