Configurar ONLYOFFICE

Esta guía ayuda a instalar y configurar ONLYOFFICE con OpenKM.

Nota

ONLYOFFICE cumple con WOPI. Lea la especificación en https://wopi.readthedocs.io/projects/wopirest/en/latest/index.html

Nota

Documentación de ONLYOFFICE: https://api.onlyoffice.com/editors/wopi/

Instalación de ONLYOFFICE

Primero, averigüe la dirección IP del equipo, por ejemplo 192.168.1.38; en adelante, usaremos esta IP en esta guía.

Ejecute los siguientes comandos para instalar el contenedor Docker:

• Descargue el script:

$ wget http://download.onlyoffice.com/docs/docs-enterprise-install.sh

• Ejecute el script:

$ bash docs-enterprise-install.sh -skiphc true -dp 8082

Configuración

Dentro del contenedor Docker, edite /etc/onlyoffice/documentserver/default.json. Tras eso, es necesario reiniciar el servicio: supervisorctl restart all.

Precaución

WOPI debe habilitarse manualmente editando este default.json y estableciendo el parámetro “wopi” en true.

Acceso a ONLYOFFICE

Pruébelo en su navegador web: http://192.168.1.38:8082/

Discovery**:**

• Abra su navegador web y ejecute la siguiente URL: http://192.168.1.38:8082/hosting/discovery

Capabilities**:**

• Abra su navegador web y ejecute la siguiente URL: http://192.168.1.38:8082/hosting/capabilities

Validador WOPI

Precaución

Este paso es opcional.

Sirve para validar los endpoints REST del host WOPI (OpenKM).

• Instálelo:

docker pull tylerbutler/wopi-validator

• Ejecútelo:

docker run -it --rm tylerbutler/wopi-validator -- -w http://localhost:8080/openkm/wopi/files/80ffd1eb-a6b8-4ec2-adc1-a58b23815eaf -t <openkm token> -l 36000000

Nota

80ffd1eb-a6b8-4ec2-adc1-a58b23815eaf es el UUID de un documento en OpenKM.

Configuración de OpenKM

Edite los siguientes parámetros de configuración desde la administración de OpenKM:

Precaución

La IP de origen de ONLYOFFICE está en un rango de red Docker, normalmente algo como 172.17.x.x, así que esa IP debe ser la configurada en el parámetro de configuración onlyoffice.ip. El token de autenticación usado entre ONLYOFFICE y OpenKM está restringido por IP; eso significa que solo la IP de ONLYOFFICE podrá usarlo.

Si no está seguro de la IP de ONLYOFFICE, revise el fichero de registro en busca de un mensaje de error como “Error validating token IP where {} != {}”, o entre en el contenedor Docker (docker exec -it name_container bash) y consulte la IP: cat /etc/hosts

# value samplesonline.office.action.url = http://192.168.1.38:8080/openkm/wopi/files
online.office.url = http://192.168.1.38:8082/hosting/discovery
online.office.ip = 172.19.0.2extension.extra.tab.workspace = Online Editor;/openkm/onlineOffice/onlyoffice

Parámetros:

• online.office.action.url: URL usada por el contenedor Docker de ONLYOFFICE para conectar con el endpoint REST WOPI de OpenKM.
• online.office.url: URL usada por OpenKM para conectar con el contenedor Docker de ONLYOFFICE.
• online.office.ip: IP de origen usada por ONLYOFFICE para autenticarse ante OpenKM.
• extension.extra.tab.workspace: para acceder desde el menú principal superior de la interfaz de usuario de OpenKM.

Precaución

Para información sobre cómo habilitar el parámetro llamado “extension.extra.tab.workspace”, consulte las secciones Extra tab workspace extension y Enable extensions de la documentación.

URLs de ejemplo:

• http://localhost:8080/openkm/onlineOffice/onlyoffice?uuid=02090e71-8283-43d7-be2a-d6f141c3f8b0
• http://192.168.1.38:8080/openkm/onlineOffice/onlyoffice?uuid=02090e71-8283-43d7-be2a-d6f141c3f8b0
• http://192.168.1.38:8080/openkm/onlineOffice/onlyoffice?uuid=02090e71-8283-43d7-be2a-d6f141c3f8b0&lang=en-gb