Strapi

Requisitos

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

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

  Por favor, consulta la página de documentación oficial para obtener más información sobre cómo instalar ONLYOFFICE Docs.
• Strapi v4.2.0 o posterior
• Conector ONLYOFFICE v1.1.0 para Strapi

Instalación del plugin de integración de ONLYOFFICE para Strapi

1. Para permitir insertar un marco con el editor y cargar api.js, reemplaza la línea strapi::security en el archivo strapi/config/middlewares.js con la siguiente configuración:

    { name: "strapi::security", config: { contentSecurityPolicy: { useDefaults: true, directives: { "script-src": ["'self'", "https:", "http:"], "frame-src": ["'self'", "https:", "http:"], }, }, } }, 

   Si ya existe tal configuración, solo necesitas agregar directives.

2. Instala el plugin en tu proyecto Strapi:

   npm install onlyoffice-strapi --save

3. Reconstruye y reinicia Strapi para incluir el plugin de ONLYOFFICE en la interfaz de administración. Ejecuta:

    # usando yarn yarn build yarn develop # usando npm npm run build npm run develop 

   Ahora el plugin de integración de ONLYOFFICE para Strapi está instalado y listo para ser configurado. El plugin se puede acceder desde el panel izquierdo en la sección Extensiones bajo el nombre ONLYOFFICE.

   

Configuración del plugin de integración de ONLYOFFICE para Strapi

Para configurar el plugin de integración de ONLYOFFICE en Strapi:

1. Abre la sección Configuración en el panel izquierdo.
2. En la sección Configuración global, haz clic en el elemento de menú ONLYOFFICE.
3. En la página de configuración de ONLYOFFICE, ingresa la dirección del servidor de documentos, es decir, la URL de ONLYOFFICE Docs instalado.
   La dirección de ONLYOFFICE Docs debe ser accesible desde Strapi, así como la dirección de Strapi debe ser accesible desde ONLYOFFICE Docs.

Cómo funciona

La interacción usuario-documento 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 mostrados 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 un 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 en el 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 crear un documento fácilmente sin la necesidad de ejecutar realmente un editor de procesamiento de documentos.

Por favor, ten en cuenta que el Servidor de Documentos 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 ONLYOFFICE en su propio servidor.

Habilitando JWT para la integración de ONLYOFFICE y Strapi

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 no es válido, el comando no se ejecuta. Para obtener más información, por favor lee la guía de Seguridad API.

Para proteger tus documentos con JWT,

1. Abre la sección Configuración en el panel izquierdo.
2. En la sección Configuración global, haz clic en el elemento de menú ONLYOFFICE.
3. En la página de configuración de ONLYOFFICE, ingresa la clave secreta en el campo Clave secreta JWT del servidor de documentos. Más información se puede encontrar aquí.
   

   Ahora que el plugin de integración de ONLYOFFICE está configurado, puedes comenzar a usarlo.