SharePoint

Requisitos

• Servidor de Documentos ONLYOFFICE v7.1 (servidor o versión en la nube) o posterior
  Necesitas habilitar WOPI siguiendo esta instrucción.

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable desde tanto SharePoint como cualquier cliente final. También debe poder realizar POST directamente a SharePoint.

  Consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
• SharePoint 2019
• Conector ONLYOFFICE 3.0 para SharePoint

Instalación y configuración de ONLYOFFICE y SharePoint

La solución de integración de ONLYOFFICE SharePoint es un conector oficial de ONLYOFFICE disponible en la página de GitHub bajo la licencia GNU AGPL v.3.

1. Haz clic en Inicio, apunta a Todos los programas, apunta a Herramientas administrativas, luego haz clic en Servicios, y asegúrate de que el servicio Administración de SharePoint esté iniciado.
2. Haz clic en Inicio, abre el Shell de administración de SharePoint, y navega al directorio que contiene el archivo .wsp.
3. Ejecuta el script Install.ps1:

   PS> .\Install.ps1

4. Ingresa la dirección de tu sitio de SharePoint:

   https://<yoursite>

   En lugar de los pasos 3 y 4 puedes escribir el siguiente comando:

   Add-SPSolution -LiteralPath<rutaalsolucion>/onlyoffice.wsp

   En la página de inicio de Administración Central de SharePoint, haz clic en Configuración del sistema > Administración de la granja > Administrar soluciones de la granja. En la página de Administración de Soluciones, haz clic en onlyoffice.wsp, luego haz clic en Desplegar Solución.

5. En la página de inicio de Administración Central de SharePoint, bajo Administración de Aplicaciones, haz clic en Administrar aplicaciones web.
6. Asegúrate de seleccionar tu sitio y haz clic en el icono de Proveedores de Autenticación.
7. En la ventana emergente de Proveedores de Autenticación, haz clic en Zona predeterminada.
8. Bajo Editar Autenticación, marca Habilitar acceso anónimo y haz clic en Guardar.
9. Volviendo a Administración de Aplicaciones Web, haz clic en el icono de Política Anónima.
10. Bajo Restricciones de Acceso Anónimo, selecciona tu Zona y establece la política Permisos a Ninguno – No y haz clic en Guardar.
11. En SharePoint, abre la página /_layouts/15/Onlyoffice/Settings.aspx con configuraciones administrativas. Ingresa la siguiente dirección:

    https://<servidordocumentos>/

    Donde el servidordocumentos es el nombre del servidor con ONLYOFFICE Docs instalado. La dirección debe ser accesible para el navegador del usuario y desde el servidor de SharePoint. La dirección del servidor de SharePoint también debe ser accesible desde ONLYOFFICE Docs para un funcionamiento correcto.

A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Necesitas habilitarlo también en el lado de SharePoint: encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especifica la misma clave secreta en la configuración administrativa de SharePoint. Para más detalles, consulta la sección Habilitar JWT para la integración de ONLYOFFICE y SharePoint de este artículo.

Si la protección JWT está habilitada, es necesario especificar un nombre de encabezado personalizado, ya que la política de seguridad de SharePoint bloquea los encabezados externos 'Authorization'. Este encabezado debe especificarse también en la configuración de firma de ONLYOFFICE Docs (más información se puede encontrar aquí).

Compilación de la solución de integración de ONLYOFFICE SharePoint

Hay dos formas de compilar la solución de integración de ONLYOFFICE SharePoint:

• Usando MS Visual Studio:
  1. Ingresa al servidor de SharePoint y abre este proyecto en Visual Studio.
  2. En Explorador de Soluciones, abre el menú contextual para el proyecto y luego elige Publicar.
  3. En el cuadro de diálogo Publicar, elige el botón de opción Publicar en el Sistema de Archivos.
  4. Haz clic en el botón Publicar. Cuando el proceso de publicación termine, se creará el archivo de solución .wsp.
  5. Copia el archivo resultante a la carpeta con el archivo Install.ps1 (carpeta BuildAndInstall por defecto).
• Con la ayuda del archivo build.bat proporcionado:
  1. Ve a la carpeta BuildAndInstall.
  2. Ejecuta el archivo build.bat.
  3. El archivo de solución resultante .wsp se creará y colocará en la carpeta BuildAndInstall.

Cómo funciona

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

1. El usuario navega a un documento dentro de SharePoint y selecciona la acción Editar en ONLYOFFICE en el menú contextual o la cinta de opciones.
2. SharePoint realiza una solicitud a la página del editor (URL con el formato: /_layouts/15/Onlyoffice/editorPage.aspx?SPListItemId={ItemId}&SPListURLDir={ListUrlDir}&action=track).
3. SharePoint prepara un objeto JSON con las siguientes propiedades:
   • url - la URL que ONLYOFFICE Docs utiliza para descargar el documento;
   • callbackUrl - la URL que ONLYOFFICE Docs informa sobre el estado de la edición del documento;
   • DocumentSeverHost - la URL a la que el cliente necesita responder al Servidor de Documentos ONLYOFFICE (puede configurarse en la página de configuración);
   • Key - el identificador del archivo de SharePoint;
   • FileName - el título del documento (nombre);
   • CurrentUserId - el identificador del usuario;
   • CurrentUserName - el nombre de usuario.
4. SharePoint construye una página, completando todos esos valores para que el navegador del cliente pueda cargar el editor.
5. 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 mencionadas.
6. Luego ONLYOFFICE Docs descarga el documento desde SharePoint y el usuario comienza a editar.
7. Cuando todos los usuarios y navegadores de clientes han terminado de editar, cierran la ventana de edición.
8. Después de 10 segundos de inactividad, ONLYOFFICE Docs envía un POST a callbackUrl informando a la solución ONLYOFFICE de SharePoint que los clientes han terminado de editar el documento y lo han cerrado.
9. SharePoint descarga una nueva versión del documento, reemplazando la antigua.

Habilitar JWT para la integración de ONLYOFFICE y SharePoint

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 – ingresa 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 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. 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 predeterminado 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 surtan 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 en el campo Clave secreta y guarda la configuración.