Configurar Office Online Server para SharePoint Server

Artículo
03/17/2023

Resumen: Obtenga información sobre cómo configurar SharePoint Server para usar Office Online Server (la siguiente versión de Office Web Apps Server).

Público: profesionales de TI

En este artículo se recoge dónde Office Online Server dejó implementar. En ese artículo, configurará el servidor que ejecuta Office Online Server local. En este caso, configurará SharePoint Server para que use Office Online Server. En primer lugar, tendrá que ejecutar algunos cmdlets de Microsoft PowerShell desde SharePoint Server 2016, después de lo cual los usuarios podrán abrir archivos de Office desde bibliotecas de documentos de SharePoint Server en un explorador.

Antes de configurar SharePoint Server para usar Office Online Server

Algunas cosas que debe comprobar antes de empezar:

Estas instrucciones también se aplican a SharePoint Server 2013, pero SharePoint Server 2013 no puede usar la funcionalidad de actualización de datos y conectividad de datos externos de Excel Online en Office Online Server.
Instale SharePoint Server 2016. Consulte Instalación de SharePoint Server para obtener instrucciones.
Asegúrese de que todas las aplicaciones web de SharePoint Server 2016 usan la autenticación basada en notificaciones. La representación y edición de Office Online no funcionarán en aplicaciones web de SharePoint Server 2016 que usen la autenticación en modo clásico.
Para permitir a los usuarios editar (no solo leer) documentos de Office en un explorador web, necesitará una licencia de edición. Además, deberá habilitar la edición en la granja de Office Online Server.
Si inicia sesión en SharePoint Server 2016 mediante la cuenta del sistema, no podrá probar la conexión entre SharePoint Server 2016 y Office Online Server. Si desea hacerlo, inicie sesión con otra cuenta.
Las condiciones de memoria insuficiente pueden provocar errores de vista previa de documentos de Office en Office Online.
SharePoint Server 2013 no puede usar la funcionalidad de actualización de datos y conectividad de datos externos de Excel Online en Office Online Server. Solo está disponible con SharePoint Server 2016.
Office Online Server usa tokens de OAuth para comunicarse con SharePoint Server. Estos tokens se pueden interceptar y reproducir potencialmente, lo que proporciona a un atacante los mismos derechos que el usuario que realiza la solicitud de SharePoint Server a Office Online Server. Se recomienda encarecidamente configurar Office Online Server para usar solo HTTPS (TLS).

Configurar SharePoint Server para usar Office Online Server

Elija una de las secciones siguientes, en función de si desea usar HTTP o HTTPS. HTTP se suele recomendar únicamente para entornos de prueba. En entornos de producción, el protocolo HTTPS más seguro es la mejor opción.

En un entorno de prueba que usa HTTP

Para esta configuración, asegúrese de que ha configurado Office Online Server siguiendo los pasos descritos en Implementación de un único servidor Office Online Server granja de servidores que usa HTTP. Asegúrese de configurar la granja de Office Online Server para que use una dirección URL interna y HTTP.

Paso 1: crear el enlace entre SharePoint 2016 y Office Web Apps Server

Para empezar, abra un Shell de administración de SharePoint 2016 con privilegios elevados. (Haga clic con el botón derecho en Shell de administración de SharePoint 2016 y, a continuación, haga clic en Ejecutar como administrador).

Ejecute el comando siguiente, donde <WacServerName> es el nombre de dominio completo (FQDN) de la dirección URL que ha establecido como URL interna. Este es el punto de entrada para Office Online Server tráfico. Para este entorno de prueba, debe especificar el parámetro -AllowHTTP para permitir que SharePoint Server 2016 reciba información de detección de la granja de Office Online Server mediante HTTP. Si no especifica -AllowHTTP, SharePoint Server 2016 intentará usar HTTPS para comunicarse con la granja de Office Online Server y este comando no funcionará.


New-SPWOPIBinding -ServerName <WacServerName> -AllowHTTP

Después de ejecutar este comando, verá una lista de enlaces en el símbolo del sistema de PowerShell de Microsoft.

Paso 2: ver las zonas WOPI para los enlaces de SharePoint

Office Online Server usa zonas para determinar qué dirección URL (interna o externa) y qué protocolo (HTTP o HTTPS) usar cuando se comunica con el host, en este caso, SharePoint Server 2016. De forma predeterminada, SharePoint Server 2016 usa la zona internal-https . Ejecute el siguiente comando para ver su zona actual.

Get-SPWOPIZone

La zona WOPI mostrada por este comando debe ser internal-http. Si se muestra correctamente, vaya al paso 4. Si no es así, consulte el paso siguiente.

Paso 3: cambiar la zona WOPI a internal-http

Si el resultado del paso 3 es internal-https, ejecute el comando siguiente para cambiar la zona a internal-http. Debe realizar este cambio porque la zona de SharePoint Server 2016 debe coincidir con la zona de la granja de Office Online Server.

Set-SPWOPIZone -zone "internal-http"

Para comprobar que la nueva zona es internal-http, vuelva a ejecutar Get-SPWOPIZone.

Paso 4: cambiar el valor AllowOAuthOverHttp a True en SharePoint 2016

Para usar Office Online con SharePoint Server 2016 a través de HTTP en un entorno de prueba, debe establecer AllowOAuthOverHttp en True. De lo contrario, Office Online no funcionará. Para comprobar el estado actual, ejecute el ejemplo siguiente.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Si este comando devuelve False, ejecute los comandos siguientes para establecerlo en True.

$config = (Get-SPSecurityTokenServiceConfig)

$config.AllowOAuthOverHttp = $true

$config.Update()

Ejecute de nuevo el comando siguiente para comprobar que el valor AllowOAuthOverHttp ya se encuentra establecido en True.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Paso 5: habilitar la API de SOAP de Excel

La API SOAP de Excel es necesaria para la actualización de datos programada con Excel Online y para la representación de elementos web de Excel. Para habilitar la API SOAP de Excel, debe agregar la propiedad WopiLegacySoapSupport a las propiedades de la granja de servidores de SharePoint Server mediante PowerShell. El parámetro de entrada es la dirección URL de ExcelServiceInternal.asmx. Esta dirección URL puede dirigirse a varios servidores OOS mediante el equilibrio de carga. Simplemente reemplace la cadena> por la <ruta de acceso de Office Online Server.

Para habilitar la API SOAP de Excel, ejecute la siguiente instancia de PowerShell, donde <url> es la dirección URL de la granja de Office Online Server. (Por ejemplo, http://OfficeOnlineServer.contoso.com.)


$Farm = Get-SPFarm
$Farm.Properties.Add("WopiLegacySoapSupport", "<URL>/x/_vti_bin/ExcelServiceInternal.asmx");
$Farm.Update();

Paso 6: comprobar que Office Web Apps está funcionando

En SharePoint Server 2016, asegúrese de que no ha iniciado sesión como cuenta del sistema porque no podrá editar ni ver los documentos con Office Online. Vaya a una biblioteca de documentos de SharePoint Server 2016 que contenga documentos de Office y vea un archivo de Word, PowerPoint, Excel o OneNote. El documento debe abrirse en un explorador que muestre el archivo mediante Office Online.

En un entorno de producción que usa HTTPS

Antes de iniciar los procedimientos siguientes, asegúrese de que ha configurado Office Online Server siguiendo los pasos descritos en Implementación de un único servidor Office Online Server granja de servidores que usa HTTPS o Implementación de una granja de servidores Office Online Server con equilibrio de carga múltiple que usa HTTPS.

Paso 1: crear el enlace entre SharePoint 2016 y Office Online Server


New-SPWOPIBinding -ServerName <WacServerName>

Paso 2: ver la zona WOPI de SharePoint 2016

Office Online Server usa zonas para determinar qué dirección URL (interna o externa) y qué protocolo (HTTP o HTTPS) usar cuando se comunica con el host, que en este caso es SharePoint Server 2016. De forma predeterminada, SharePoint Server 2016 usa la zona internal-https . Para comprobar que esta es la zona activa, ejecute el comando siguiente.

Get-SPWOPIZone

Anote la zona WOPI que aparece.

Paso 3: cambiar la zona WOPI si es necesario

En función del entorno, es posible que deba cambiar la zona WOPI. Si la granja de servidores de SharePoint es tanto interna como externa, especifique que es externa. Si solo es interna, especifíquelo.

Si los resultados del paso 2 muestran que internal-https y la granja de SharePoint son solo internas, puede omitir este paso. Si tiene una granja de SharePoint interna y externa, debe ejecutar el siguiente comando para cambiar la zona a external-https.

Set-SPWOPIZone -zone "external-https"

Paso 4: habilitar la API de SOAP de Excel

Para habilitar la API SOAP de Excel, ejecute la siguiente instancia de PowerShell, donde <url> es la dirección URL de la granja de Office Online Server. (Por ejemplo, https://OfficeOnlineServer.contoso.com.)


$Farm = Get-SPFarm
$Farm.Properties.Add("WopiLegacySoapSupport", "<URL>/x/_vti_bin/ExcelServiceInternal.asmx");
$Farm.Update();

Paso 5: comprobar que Office Web Apps está funcionando

Desconectar SharePoint Server 2016 de Office Online Server

Si por cualquier motivo quiere desconectar SharePoint Server 2016 de Office Online Server, use el siguiente ejemplo de comando.


Remove-SPWOPIBinding -All:$true