Chamilo

Cómo funciona

La integración de ONLYOFFICE sigue la API documentada aquí.

1. Para crear un archivo nuevo, el profesor abre la carpeta necesaria y hace clic en el icono Crear nuevo de ONLYOFFICE.
2. El usuario es redirigido a la página de creación de archivos donde debe ingresar el nombre y formato del archivo (documento de texto, hoja de cálculo o presentación). El navegador llama al método /plugin/onlyoffice/create.php. Este añade una copia de un archivo vacío a la carpeta del curso.
3. Para abrir un archivo existente, el usuario elige el icono Abrir con ONLYOFFICE.
4. La solicitud se envía a /plugin/onlyoffice/editor.php?docId="identificador del documento". El servidor procesa la solicitud, genera la configuración de inicialización del editor con las siguientes propiedades:
   • url - la URL que ONLYOFFICE Docs usa para descargar el documento;
   • callbackUrl - la URL que ONLYOFFICE Docs usa para informar sobre el estado de la edición del documento;
   • documentServerUrl - la URL a la que el cliente debe responder a ONLYOFFICE Docs (puede configurarse en la página de ajustes administrativos);
   • key - el etag para indicar a ONLYOFFICE Docs si debe descargar el documento nuevamente o no.
5. El servidor devuelve una página con un script para abrir el editor.
6. El navegador abre esta página y carga el editor.
7. El navegador realiza una solicitud a ONLYOFFICE Docs y le pasa la configuración del documento.
8. ONLYOFFICE Docs carga el documento y el usuario comienza a editar.
9. ONLYOFFICE Docs envía una solicitud POST a callbackUrl para informar a Chamilo que el usuario está editando el documento.
10. Cuando todos los usuarios terminan de editar, cierran la ventana del editor.
11. Después de 10 segundos, ONLYOFFICE Docs realiza una solicitud POST a callbackUrl para notificar que la sesión de edición ha finalizado y envía un enlace a la nueva versión del documento.
12. Chamilo carga la nueva versión del documento y sobrescribe el archivo.

Habilitando JWT para la integración de ONLYOFFICE y Chamilo

Para proteger los documentos del acceso no autorizado, los editores de 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 JSON web 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. Debe encontrar su 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: Encuentre su clave secreta en el archivo de configuración de ONLYOFFICE Docs

1. Abra 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 – ingrese al contenedor de ONLYOFFICE Docs usando el comando docker exec -it <containerID> bash y abra /etc/onlyoffice/documentserver/local.json

     Alternativamente, puede 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. Puede reemplazar el valor secreto predeterminado con su 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 realiza cambios, guárdelos y reinicie los servicios para que los cambios en la configuración tengan efecto.

   supervisorctl restart all

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

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

Deshabilitando el conector ONLYOFFICE para Chamilo

Si necesita deshabilitar el conector ONLYOFFICE:

1. En la página de Plugins, busque ONLYOFFICE y haga clic en Configurar.
2. Marque la casilla No en la sección Habilitar.