Configuration d’Office Online Server pour SharePoint Server

Article
03/17/2023

Résumé: Découvrez comment configurer SharePoint Server pour utiliser Office Online Server (la prochaine version d’Office Web Apps Server).

Public concerné: professionnels de l'informatique

Cet article reprend là où l’Office Online Server Déployer s’est arrêté. Dans cet article, vous allez configurer le serveur qui s’exécute Office Online Server localement. Dans celui-ci, vous allez configurer SharePoint Server pour utiliser Office Online Server. Tout d’abord, vous devez exécuter quelques applets de commande Microsoft PowerShell à partir de SharePoint Server 2016, après quoi les utilisateurs pourront ouvrir des fichiers Office à partir de bibliothèques de documents SharePoint Server dans un navigateur.

Avant de configurer SharePoint Server pour l’utilisation d’Office Online Server

Voici quelques points à vérifier avant de commencer :

Ces instructions s’appliquent également à SharePoint Server 2013, mais SharePoint Server 2013 ne peut pas utiliser la connectivité de données externes Excel Online et la fonctionnalité d’actualisation des données dans Office Online Server.
Installez SharePoint Server 2016. Pour obtenir des conseils, consultez Installer SharePoint Server .
Assurez-vous que toutes les applications web SharePoint Server 2016 utilisent l'authentification basée sur les revendications. Le rendu et la modification Office Online ne fonctionneront pas dans des applications web SharePoint Server 2016 qui utilisent l'authentification en mode classique.
Pour permettre aux utilisateurs de modifier (et non seulement de lire) des documents Office dans un navigateur web, vous aurez besoin d'une licence de modification. En outre, vous devrez activer la modification sur la batterie de serveurs Office Online Server.
Si vous vous connectez à SharePoint Server 2016 avec le compte système, vous ne pourrez pas tester la connexion entre SharePoint Server 2016 et Office Online Server. Pour tester la connexion, connectez-vous avec un autre compte.
Les problèmes de mémoire insuffisante peuvent provoquer l'échec des aperçus de documents Office dans Office Online.
SharePoint Server 2013 ne peut pas utiliser la connectivité des données externes Excel Online et la fonctionnalité d’actualisation des données dans Office Online Server. Ces fonctionnalités sont uniquement disponibles avec SharePoint Server 2016.
Office Online Server utilise des jetons OAuth pour communiquer avec SharePoint Server. Ces jetons peuvent potentiellement être interceptés et relus, ce qui fournit à un attaquant les mêmes droits que l’utilisateur qui effectue la demande à partir de SharePoint Server pour Office Online Server. Il est fortement recommandé de configurer Office Online Server pour utiliser UNIQUEMENT HTTPS (TLS).

Configuration de SharePoint Server pour l’utilisation d’Office Online Server

Choisissez l’une des sections suivantes selon que vous voulez utiliser le protocole HTTP ou HTTPS. HTTP est généralement recommandé uniquement pour les environnements de test. Dans les environnements de production, le protocole HTTPS, plus sécurisé, est le meilleur choix.

Dans un environnement de test qui utilise HTTP

Pour cette configuration, vérifiez que vous avez configuré Office Online Server en suivant les étapes décrites dans Déployer une batterie de Office Online Server à serveur unique qui utilise HTTP. Assurez-vous que vous avez configuré la batterie de serveurs Office Online Server afin d'utiliser le protocole HTTP et une URL interne.

Étape 1 : créer la liaison entre SharePoint 2016 et Office Web Apps Server

Pour commencer, ouvrez un SharePoint 2016 Management Shell avec élévation de privilèges. (Cliquez avec le bouton droit sur SharePoint 2016 Management Shell, puis cliquez sur Exécuter en tant qu’administrateur.)

Exécutez la commande suivante où <WacServerName> désigne le nom de domaine complet (FQDN) de l’URL que vous avez définie pour l’URL interne. Il s'agit du point d'entrée du trafic Office Online Server. Pour cet environnement de test, vous devez spécifier le paramètre -AllowHTTP pour autoriser SharePoint Server 2016 à recevoir des informations de découverte de la batterie Office Online Server à l'aide du protocole HTTP. Si vous ne spécifiez pas le paramètre -AllowHTTP, SharePoint Server 2016 essaiera d'utiliser le protocole HTTPS avec la batterie Office Online Server et cette commande ne fonctionnera pas.


New-SPWOPIBinding -ServerName <WacServerName> -AllowHTTP

Après avoir exécuté cette commande, vous devez voir une liste de liaisons s'afficher à l'invite de commandes Microsoft PowerShell.

Étape 2 : afficher les zones WOPI pour les liaisons SharePoint

Office Online Server utilise des zones pour déterminer l'URL (interne ou externe) et le protocole (HTTP ou HTTPS) à utiliser au moment de communiquer avec l'hôte, soit SharePoint Server 2016 dans le cas présent. Par défaut, SharePoint Server 2016 utilise la zone internal-https. Vérifiez qu'il s'agit de la zone actuelle en exécutant la commande suivante :

Get-SPWOPIZone

La zone WOPI affichée par cette commande doit être internal-http. Si elle s'affiche correctement, passez à l'étape 4. Dans le cas contraire, reportez-vous à l'étape suivante.

Étape 3 : définir la zone WOPI sur internal-http

Si le résultat de l'étape 3 était internal-https, exécutez la commande suivante pour redéfinir la zone en internal-http. Ce changement est obligatoire car la zone SharePoint Server 2016 doit correspondre à la zone de la batterie Office Online Server.

Set-SPWOPIZone -zone "internal-http"

Vérifiez que la nouvelle zone est internal-http en exécutant Get-SPWOPIZone à nouveau.

Étape 4 : définir le paramètre AllowOAuthOverHttp dans SharePoint 2016 sur True

Pour utiliser Office Online avec SharePoint Server 2016 sur HTTP dans un environnement de test, vous devez définir AllowOAuthOverHttp sur True. Sinon, Office Online ne fonctionnera pas. Vous pouvez case activée la status actuelle en exécutant l’exemple suivant.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Si cette commande renvoie la valeur False, exécutez les commandes suivantes pour la définir sur True.

$config = (Get-SPSecurityTokenServiceConfig)

$config.AllowOAuthOverHttp = $true

$config.Update()

Exécutez de nouveau la commande suivante pour vérifier que le paramètre AllowOAuthOverHttp est à présent défini sur True.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Étape 5 : activer l'API SOAP Excel

L'API SOAP Excel est nécessaire pour l'actualisation planifiée des données avec Excel Online et pour le rendu des composants WebPart d'Excel. Pour activer l'API SOAP Excel, vous devez ajouter la propriété WopiLegacySoapSupport aux propriétés de la batterie SharePoint Server à l'aide de PowerShell. Le paramètre d'entrée est l'URL menant à ExcelServiceInternal.asmx. Cette URL peut adresser plusieurs serveurs OOS via l'équilibrage de charge. Remplacez simplement la <chaîne> par votre chemin d’accès Office Online Server.

Pour activer l’API SOAP Excel, exécutez la commande PowerShell suivante, où <URL> est l’URL de votre batterie de Office Online Server. (Par exemple, http://OfficeOnlineServer.contoso.com.)


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

Étape 6 : vérifier qu’Office Web Apps fonctionne

Dans SharePoint Server 2016, assurez-vous que vous n'êtes pas connecté en tant que compte système car vous ne pourrez pas modifier ou afficher les documents à l'aide d'Office Online. Accédez à une bibliothèque de documents SharePoint Server 2016 qui contient des documents Office et affichez un fichier Word, PowerPoint, Excel ou OneNote. Le document doit s'ouvrir dans un navigateur qui affiche le fichier au moyen d'Office Online.

Dans un environnement de production qui utilise le protocole HTTPS

Avant de commencer les procédures suivantes, vérifiez que vous avez configuré Office Online Server en suivant les étapes décrites dans Déployer une batterie de Office Online Server à serveur unique qui utilise HTTPS ou Déployer une batterie de serveurs multiserveur Office Online Server à charge équilibrée qui utilise HTTPS.

Étape 1 : créer la liaison entre SharePoint 2016 et Office Online Server


New-SPWOPIBinding -ServerName <WacServerName>

Étape 2 : afficher la zone WOPI de SharePoint 2016

Office Online Server utilise des zones pour déterminer l'URL (interne ou externe) et le protocole (HTTP ou HTTPS) à utiliser au moment de communiquer avec l'hôte, soitSharePoint Server 2016 dans le cas présent. Par défaut, SharePoint Server 2016 utilise la zone internal-https. Vérifiez qu'il s'agit de la zone actuelle en exécutant la commande suivante.

Get-SPWOPIZone

Prenez note de la zone WOPI qui s’affiche.

Étape 3 : modifier la zone WOPI si nécessaire

En fonction de votre environnement, vous devrez peut-être modifier la zone WOPI. Si vous avez une batterie de serveurs SharePoint qui est à la fois interne et externe, spécifiez externe. Si votre batterie de serveurs SharePoint est exclusivement interne, précisez interne.

Si les résultats de l'étape 2 affichent internal-https et que la batterie de serveurs SharePoint est uniquement interne, vous pouvez passer outre cette étape. Si vous avez une batterie de serveurs SharePoint interne et externe à la fois, vous devez exécuter la commande suivante pour modifier la zone et la définir sur external-https.

Set-SPWOPIZone -zone "external-https"

Étape 4 : activer l'API SOAP Excel

Pour activer l’API SOAP Excel, exécutez la commande PowerShell suivante, où <URL> est l’URL de votre batterie de Office Online Server. (Par exemple, https://OfficeOnlineServer.contoso.com.)


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

Étape 5 : vérifier qu’Office Web Apps fonctionne

Déconnexion de SharePoint Server 2016 d’Office Online Server

Si, pour une raison quelconque, vous cherchez à déconnecter SharePoint Server 2016 d'Office Online Server, utilisez l'exemple de commande suivant.


Remove-SPWOPIBinding -All:$true