Chamilo

Cómo funciona

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

1. Para crear un nuevo archivo, 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. El sistema 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 utiliza para descargar el documento;
   • callbackUrl - la URL que ONLYOFFICE Docs utiliza para informar sobre el estado de edición del documento;
   • documentServerUrl - la URL que el cliente necesita para responder a ONLYOFFICE Docs (puede configurarse en la página de configuración administrativa);
   • key - el ETag para instruir 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 han terminado 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 terminado y envía un enlace a una nueva versión del documento.
12. Chamilo carga una nueva versión del documento y sobrescribe el archivo.

Habilitar JWT para la integración de ONLYOFFICE y Chamilo

Para proteger los documentos del acceso no autorizado, los editores de ONLYOFFICE utilizan el 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 utiliza para firmar el token web JSON y validar el token al realizar 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. 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 – entra 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 por defecto 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 por defecto 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 secreta en el campo Clave secreta y guarda la configuración.

Deshabilitar el conector de ONLYOFFICE para Chamilo

Si necesitas deshabilitar el conector de ONLYOFFICE:

1. En la página de Extensiones, encuentra ONLYOFFICE y haz clic en Configurar.
2. Marca la casilla No en la sección Habilitar.