Configurare Office Online Server per SharePoint Server

Riepilogo: Informazioni su come configurare SharePoint Server per l'uso di Office Online Server (la versione successiva di Office App Web Server).

Destinatari: professionisti IT

In questo articolo viene visualizzata la posizione in cui è stata interrotta la Office Online Server Distribuisci. In questo articolo viene configurato il server che esegue Office Online Server locale. In questo si configurerà SharePoint Server per l'uso di Office Online Server. Prima di tutto, è necessario eseguire alcuni cmdlet di Microsoft PowerShell da SharePoint Server 2016, dopo di che gli utenti potranno aprire i file di Office dalle raccolte documenti di SharePoint Server in un browser.

Prima di configurare SharePoint Server per l'uso di Office Online Server

Ecco alcune cose da verificare prima di iniziare:

  • Queste istruzioni si applicano anche a SharePoint Server 2013, tuttavia SharePoint Server 2013 non può usare la connettività dei dati esterni di Excel Online e la funzionalità di aggiornamento dei dati in Office Online Server.

  • Installare SharePoint Server 2016. Per indicazioni, vedere Installare SharePoint Server .

  • Verificare che tutte le applicazioni Web di SharePoint Server 2016 usino l'autenticazione basata sulle attestazioni. Il rendering e la modifica di Office Online non funzionano nelle applicazioni Web di SharePoint Server 2016 che usano l'autenticazione in modalità classica.

  • Per consentire agli utenti di modificare (non solo leggere) i documenti di Office in un Web browser, è necessaria una licenza di modifica. Sarà inoltre necessario abilitare la modifica nella farm Office Online Server.

  • Se si accede a SharePoint Server 2016 con l'account di sistema, non sarà possibile testare la connessione tra SharePoint Server 2016 e il Office Online Server. Per testare la connessione è necessario accedere con un account diverso.

  • Condizioni di memoria insufficiente possono fare in modo che le anteprime dei documenti di Office abbiano esito negativo in Office Online.

  • SharePoint Server 2013 non può usare la funzionalità di connettività dei dati esterni e di aggiornamento dei dati di Excel Online in Office Online Server. È disponibile sono con SharePoint Server 2016.

  • Office Online Server usa i token OAuth per comunicare con SharePoint Server. Questi token possono essere potenzialmente intercettati e riprodotti, fornendo a un utente malintenzionato gli stessi diritti dell'utente che effettua la richiesta da SharePoint Server a Office Online Server. È consigliabile configurare Office Online Server solo per l'uso di HTTPS (TLS).

Configurare SharePoint Server per l'uso di Office Online Server

Scegliere una delle sezioni seguenti a seconda che si voglia usare HTTP o HTTPS. HTTP generalmente è consigliato solo per gli ambienti di testing. Negli ambienti di produzione il protocollo HTTPS, più sicuro, è la scelta migliore.

In un ambiente di testing che usa HTTP

Per questa configurazione, assicurarsi di aver configurato Office Online Server seguendo la procedura descritta in Distribuire una farm Office Online Server a server singolo che usa HTTP. Configurare la farm di Office Online Server per l'uso di un URL interno e del protocollo HTTP.

Passaggio 1: creare l'associazione tra SharePoint 2016 e il server Office Web Apps

Per iniziare, aprire SharePoint 2016 Management Shell con privilegi elevati. Fare clic con il pulsante destro del mouse su Shell di gestione SharePoint 2016 e quindi scegliere Esegui come amministratore.

Eseguire il comando seguente, dove <WacServerName> è il nome di dominio completo (FQDN) dell'URL impostato per l'URL interno. Questo è il punto di ingresso per il traffico Office Online Server. Per questo ambiente di test, è necessario specificare il parametro -AllowHTTP per consentire a SharePoint Server 2016 di ricevere informazioni di individuazione dalla farm Office Online Server tramite HTTP. Se non si specifica -AllowHTTP, SharePoint Server 2016 proverà a usare HTTPS per comunicare con la farm Office Online Server e questo comando non funzionerà.


New-SPWOPIBinding -ServerName <WacServerName> -AllowHTTP

Dopo l'esecuzione del comando, dovrebbe comparire un elenco di associazioni nel prompt dei comandi di Microsoft PowerShell.

Passaggio 2: visualizzare le aree WOPI per le associazioni di SharePoint

Il Office Online Server usa le zone per determinare quale URL (interno o esterno) e quale protocollo (HTTP o HTTPS) usare per comunicare con l'host, che in questo caso è SharePoint Server 2016. Per impostazione predefinita, SharePoint Server 2016 usa la zona internal-https. Verificare qual è la zona corrente eseguendo il comando seguente:

Get-SPWOPIZone

La zona WOPI visualizzata da questo comando deve essere internal-http. Se viene visualizzato correttamente, andare al passaggio 4. In caso contrario, vedere il passaggio successivo.

Passaggio 3: modificare l'area WOPI e impostarla su internal-http

Se il risultato del passaggio 3 era internal-https, eseguire il comando seguente per modificare la zona in internal-http. Questa modifica è necessaria poiché la zona di SharePoint Server 2016 deve corrispondere alla zona della farm di Office Online Server.

Set-SPWOPIZone -zone "internal-http"

Verificare che la nuova zona sia internal-http eseguendo di nuovo Get-SPWOPIZone.

Passaggio 4: modificare l'impostazione AllowOAuthOverHttp in SharePoint 2016 su True

Per usare Office Online con SharePoint Server 2016 su HTTP in un ambiente di test, è necessario impostare AllowOAuthOverHttp su True. In caso contrario, Office Online non funzionerà. È possibile controllare lo stato corrente eseguendo l'esempio seguente.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Se il comando restituisce False, eseguire i comandi seguenti per impostare il valore su True.

$config = (Get-SPSecurityTokenServiceConfig)
$config.AllowOAuthOverHttp = $true
$config.Update()

Eseguire di nuovo il comando seguente per verificare che AllowOAuthOverHttp sia impostato su True.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Passaggio 5: abilitare l'API SOAP di Excel

L'API SOAP di Excel è necessaria per l'aggiornamento dei dati pianificato con Excel Online e per il rendering della Web part Excel. Per abilitare l'API SOAP di Excel, è necessario aggiungere la proprietà WopiLegacySoapSupport alle proprietà della farm di SharePoint Server mediante PowerShell. Il parametro di input è l'URL a ExcelServiceInternal.asmx. Questo URL può indirizzare a più server OOS tramite il bilanciamento del carico. Sostituire semplicemente la stringa> con il <percorso Office Online Server.

Per abilitare l'API SOAP di Excel, eseguire PowerShell seguente, dove <URL> è l'URL della farm Office Online Server. Ad esempio, http://OfficeOnlineServer.contoso.com.).


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

Passaggio 6: verificare che Office Web Apps funzioni

In SharePoint Server 2016 assicurarsi di non avere effettuato l'accesso con l'account di sistema, altrimenti non è possibile modificare o visualizzare i documenti con Office Online. Passare a una raccolta documenti di SharePoint Server 2016 che contiene documenti di Office e visualizzare un file di Word, PowerPoint, Excel o OneNote. Il documento dovrebbe aprirsi in un browser che mostra il file in Office Online.

In un ambiente di produzione che usa HTTPS

Prima di avviare le procedure seguenti, assicurarsi di aver configurato Office Online Server seguendo la procedura descritta in Distribuire una farm Office Online Server a server singolo che usa HTTPS o Distribuire una farm con più server con bilanciamento del carico Office Online Server che usa HTTPS.

Passaggio 1: creare l'associazione tra SharePoint 2016 e Office Online Server

Per iniziare, aprire SharePoint 2016 Management Shell con privilegi elevati. Fare clic con il pulsante destro del mouse su Shell di gestione SharePoint 2016 e quindi scegliere Esegui come amministratore.

Eseguire il comando seguente, dove <WacServerName> è il nome di dominio completo (FQDN) dell'URL impostato per l'URL interno. Questo è il punto di ingresso per il traffico Office Online Server.


New-SPWOPIBinding -ServerName <WacServerName> 

Passaggio 2: visualizzare l'area WOPI di SharePoint 2016

Il Office Online Server usa le zone per determinare quale URL (interno o esterno) e quale protocollo (HTTP o HTTPS) usare per comunicare con l'host, che in questo caso è SharePoint Server 2016. Per impostazione predefinita, SharePoint Server 2016 usa la zona internal-https. Verificare che questa sia la zona corrente eseguendo il comando seguente:

Get-SPWOPIZone

Prendere nota della zona WOPI visualizzata.

Passaggio 3: modificare la zona WOPI, se necessario

A seconda dell'ambiente, potrebbe essere necessario modificare la zona WOPI. Se si dispone di una farm di SharePoint sia interna che esterna, specificare external. Se invece si dispone di una farm di SharePoint solo interna, specificare internal.

Se il risultato del passaggio 2 è internal-https e la farm di SharePoint è solo interna, è possibile saltare questo passaggio. Se invece la farm di SharePoint è sia interna che esterna, è necessario eseguire il comando seguente per modificare la zona in external-https.

Set-SPWOPIZone -zone "external-https"

Passaggio 4: abilitare l'API SOAP di Excel

L'API SOAP di Excel è necessaria per l'aggiornamento dei dati pianificato con Excel Online e per il rendering della Web part Excel. Per abilitare l'API SOAP di Excel, è necessario aggiungere la proprietà WopiLegacySoapSupport alle proprietà della farm di SharePoint Server mediante PowerShell. Il parametro di input è l'URL a ExcelServiceInternal.asmx. Questo URL può indirizzare a più server OOS tramite il bilanciamento del carico. Sostituire semplicemente la stringa> con il <percorso Office Online Server.

Per abilitare l'API SOAP di Excel, eseguire PowerShell seguente, dove <URL> è l'URL della farm Office Online Server. Ad esempio, https://OfficeOnlineServer.contoso.com.).


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

Passaggio 5: verificare che Office Web Apps funzioni

In SharePoint Server 2016 assicurarsi di non avere effettuato l'accesso con l'account di sistema, altrimenti non è possibile modificare o visualizzare i documenti con Office Online. Passare a una raccolta documenti di SharePoint Server 2016 che contiene documenti di Office e visualizzare un file di Word, PowerPoint, Excel o OneNote. Il documento dovrebbe aprirsi in un browser che mostra il file in Office Online.

Disconnettere SharePoint Server 2016 da Office Online Server

Se, per qualunque motivo, si vuole disconnettere SharePoint Server 2016 dal Office Online Server, usare il comando di esempio seguente:


Remove-SPWOPIBinding -All:$true