Confluence

Cómo funciona

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

1. El usuario navega a los adjuntos de Confluence y selecciona la acción Editar en ONLYOFFICE.
2. Confluence realiza una solicitud a OnlyOfficeEditorServlet (URL de la forma: /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
3. Confluence envía un documento al servicio de almacenamiento de documentos ONLYOFFICE y recibe un enlace temporal.
4. Confluence prepara un objeto JSON con las siguientes propiedades:
   • url - el enlace temporal 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;
   • docserviceApiUrl - la URL a la que el cliente debe responder a ONLYOFFICE Docs (proporcionada por la propiedad files.docservice.url.api);
   • key - el UUID para indicar a ONLYOFFICE Docs si debe descargar el documento nuevamente o no;
   • title - el título (nombre) del documento.
5. Confluence usa este objeto para generar una página a partir de una plantilla freemarker, llenándola con los valores proporcionados para permitir que el navegador del cliente cargue el editor.
6. El navegador del cliente realiza una solicitud a la biblioteca JavaScript de ONLYOFFICE Docs y envía a ONLYOFFICE Docs la configuración de DocEditor con las propiedades anteriores.
7. Luego ONLYOFFICE Docs descarga el documento desde Confluence y el usuario comienza a editar.
8. Cuando todos los usuarios y navegadores clientes terminan de editar, cierran la ventana de edición.
9. Después de 10 segundos de inactividad, ONLYOFFICE Docs envía un POST a callbackUrl informando a Confluence que los clientes han terminado de editar el documento y lo han cerrado.
10. Confluence descarga una nueva versión del documento, reemplazando la antigua.

Habilitar JWT para la integración de ONLYOFFICE y Confluence

Para proteger los documentos del acceso no autorizado, los editores 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 web JSON 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. Debes encontrar tu 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: 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 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 haces cambios, guárdalos y reinicia los servicios para que los cambios en la 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 el mismo secreto en el campo Clave secreta y guarda los ajustes.

Conectando al demo de ONLYOFFICE Docs

Si quieres probar los editores online de ONLYOFFICE dentro de Confluence sin instalar ONLYOFFICE Docs:

1. Ve a Administración de Confluence > Administrar apps > Conector ONLYOFFICE para Confluence > Configurar.
2. Marca la casilla Conectar al demo de ONLYOFFICE Document Server.
3. Haz clic en el botón Guardar.