Configurar o Servidor do Office Online para Servidor do SharePoint

Artigo
03/17/2023

Resumo: Saiba como configurar o SharePoint Server para usar Servidor do Office Online (a próxima versão do Office Aplicativos Web Server).

Audiência: profissionais de TI

Este artigo retoma de onde a implantação Servidor do Office Online parou. No mesmo artigo, você configurará o servidor que executa o Servidor do Office Online local. Neste, você configurará o SharePoint Server para usar Servidor do Office Online. Primeiro, você precisará executar alguns cmdlets do Microsoft PowerShell do SharePoint Server 2016, após os quais os usuários poderão abrir arquivos do Office de bibliotecas de documentos do SharePoint Server em um navegador.

Antes de configurar o SharePoint Server para usar o Servidor do Office Online

Alguns aspéctos que devem ser verificados antes de iniciar:

Essas instruções também se aplicam ao SharePoint Server 2013, no entanto, o SharePoint Server 2013 não pode usar a conectividade de dados externos do Excel Online e a funcionalidade de atualização de dados em Servidor do Office Online.
Instale oSharePoint Server 2016. Consulte Instalar o SharePoint Server para obter diretrizes.
Certifique-se de que todos os aplicativos Web do SharePoint Server 2016 usam autenticação baseada em declarações. O processamento e a edição do Office Online não funcionarão nos aplicativos Web do SharePoint Server 2016 que usam a autenticação no modo clássico.
Para permitir que os usuários editem (não apenas leiam) documentos do Office em um navegador da Web, é necessária uma licença de edição. Além disso, o recurso de edição precisa ser habilitado no farm do Servidor do Office Online.
Se entrar no SharePoint Server 2016 usando a Conta do sistema, não será possível testar a conexão entre o SharePoint Server 2016 e o Servidor do Office Online. Entre com uma conta diferente para testar a conexão.
Condições de memória insuficiente podem provocar falhas na visualização de documentos do Office no Office Online.
O SharePoint Server 2013 não pode usar a funcionalidade de conectividade de dados externos e atualização de dados do Excel Online em Servidor do Office Online. Isso só está disponível com o SharePoint Server 2016.
Servidor do Office Online usa tokens OAuth para se comunicar com o SharePoint Server. Esses tokens podem potencialmente ser interceptados e reproduzidos, fornecendo a um invasor os mesmos direitos que o usuário que faz a solicitação do SharePoint Server para Servidor do Office Online. É altamente recomendável que você configure apenas Servidor do Office Online usar o HTTPS (TLS).

Configurar o SharePoint Server para usar o Servidor do Office Online

Escolha uma das seguintes seções, dependendo se você quer usar HTTP ou HTTPS. HTTP geralmente é recomendado apenas para ambientes de teste. Em ambientes de produção, o protocolo HTTPS, mais seguro é a melhor opção.

Em um ambiente de teste que usa HTTP

Para essa configuração, verifique se você configurou Servidor do Office Online seguindo as etapas em Implantar um farm de Servidor do Office Online de servidor único que usa HTTP. Configure a farm do Servidor do Office Online para usar uma URL e um HTTP internos.

Etapa 1: criar a associação entre o SharePoint 2016 e Office Web Apps Server

Para começar, abra um Shell de Gerenciamento do SharePoint 2016 elevado. (Clique com o botão direito do mouse no Shell de Gerenciamento do SharePoint 2016 e clique em Executar como Administrador.)

Execute o comando a seguir, em que <WacServerName> é o nome de domínio totalmente qualificado (FQDN) da URL que você definiu para a URL interna. Este é o ponto de entrada de tráfego do Servidor do Office Online. Para este ambiente de teste, é preciso especificar o parâmetro -AllowHTTP para permitir que o SharePoint Server 2016 receba informações descobertas da farm do Servidor do Office Online usando o HTTP. Se não especificar -AllowHTTP, o SharePoint Server 2016 tentará usar HTTPS para se comunicar com a farm do Servidor do Office Online e este comando não funcionará.


New-SPWOPIBinding -ServerName <WacServerName> -AllowHTTP

Após executar este comando, você deverá ver uma lista de vínculos exibida no prompt de comando do Microsoft PowerShell.

Etapa 2: exibir as zonas WOPI para as associações do SharePoint

O Servidor do Office Online usa zonas para determinar qual URL (interna ou externa) e qual protocolo (HTTP ou HTTPS) deve ser usado durante a comunicação com o host, neste caso, o SharePoint Server 2016. Por padrão, o SharePoint Server 2016 usa a zona internal-https. Execute o seguinte comando para ver a zona atual.

Get-SPWOPIZone

A zona WOPI exibida por este comando deve ser internal-http. Se ela for exibida corretamente, pule para a etapa 4. Caso contrário, confira a próxima etapa.

Etapa 3: alterar a zona WOPI para internal-http

Se o resultado da Etapa 3 for internal-https, execute o seguinte comando para alterar a zona para internal-http. É preciso fazer esta alteração porque a zona do SharePoint Server 2016 deve corresponder à zona da farm do Servidor do Office Online.

Set-SPWOPIZone -zone "internal-http"

Verifique se a nova zona é internal-http executando o Get-SPWOPIZone novamente.

Etapa 4: alterar a configuração AllowOAuthOverHttp no SharePoint 2016 para True

Para usar o Office Online com o SharePoint Server 2016 em HTTP em um ambiente de teste, é preciso definir AllowOAuthOverHttp como True (Verdadeiro). Caso contrário, o Office Online não funcionará. Você pode verificar o status atual executando o seguinte exemplo.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Se este comando retornar False, execute os seguintes comandos para defini-lo como True.

$config = (Get-SPSecurityTokenServiceConfig)

$config.AllowOAuthOverHttp = $true

$config.Update()

Execute o comando a seguir novamente para verificar se a configuraçãoAllowOAuthOverHttp está agora definida como True.

(Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

Etapa 5: habilitar a API SOAP do Excel

A API SOAP do Excel é necessária para atualizar dados agendados com o Excel Online e para renderizar a Web Part do Excel. Para habilitar a API SOAP do Excel, você precisa adicionar a propriedade WopiLegacySoapSupport às propriedades do farm do SharePoint Server usadas pelo PowerShell. O parâmetro de entrada é a URL para ExcelServiceInternal.asmx. Essa URL pode lidar com vários servidores OOS por meio do balanceamento de carga. Basta substituir a <cadeia de caracteres> pelo caminho Servidor do Office Online.

Para habilitar a API SOAP do Excel, execute o PowerShell a seguir em que <a URL> é a URL do seu farm Servidor do Office Online. Por exemplo, http://OfficeOnlineServer.contoso.com.).


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

Etapa 6: verificar se o Office Web Apps está funcionando

No SharePoint Server 2016, verifique se você não está conectado como Conta do Sistema porque não poderá editar ou exibir os documentos com o Office Online. Acesse uma biblioteca de documentos do SharePoint Server 2016 que contém documentos do Office e exiba um arquivo Word, PowerPoint, Excel ou OneNote. O documento deve ser aberto em um navegador que exibe o arquivo usando o Office Online.

Em um ambiente de produção que usa HTTPS

Antes de iniciar os procedimentos a seguir, certifique-se de ter configurado Servidor do Office Online seguindo as etapas em Implantar um farm de Servidor do Office Online de servidor único que usa HTTPS ou Implantar um farm de Servidor do Office Online com balanceamento de carga e vários servidores que usa HTTPS.

Etapa 1: criar a associação entre o SharePoint 2016 e o Servidor do Office Online

Execute o comando a seguir, em que <WacServerName> é o nome de domínio totalmente qualificado (FQDN) da URL que você definiu para a URL interna. Esse é o ponto de entrada para o tráfego do Servidor do Office Online.


New-SPWOPIBinding -ServerName <WacServerName>

Etapa 2: exibir a zona WOPI do SharePoint 2016

O Servidor do Office Online usa o conceito de zonas para determinar qual URL (interna ou externa) e qual o protocolo (HTTP ou HTTPS) usar ao se comunicar com o host, que nesse caso é SharePoint Server 2016. Por padrão, o SharePoint Server 2016 usa a zona https interno. Verifique se esta é a zona atual, a executar o seguinte comando:

Get-SPWOPIZone

Anote a zona do WOPI exibida.

Etapa 3: alterar a zona WOPI, se necessário

Dependendo do seu ambiente, pode ser necessário alterar a zona WOPI. Se houver uma farm interna e externa do SharePoint, especifique externa. Se houver uma farm somente interno do SharePoint, especifique interna.

Se os resultados da Etapa 2 mostrarem que internal-https e o farm do SharePoint são apenas internos, ignore esta etapa. Se você tiver um farm do SharePoint que seja interno e externo, execute o seguinte comando para alterar a zona para external-https.

Set-SPWOPIZone -zone "external-https"

Etapa 4: habilitar a API SOAP do Excel

Para habilitar a API SOAP do Excel, execute o PowerShell a seguir em que <a URL> é a URL do seu farm Servidor do Office Online. Por exemplo, https://OfficeOnlineServer.contoso.com.).


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

Etapa 5: verificar se o Office Web Apps está funcionando

Desconectar o SharePoint Server 2016 para usar o Servidor do Office Online

Se, por qualquer motivo, você deseja desconectar o SharePoint Server 2016 de Servidor do Office Online, use o seguinte exemplo de comando.


Remove-SPWOPIBinding -All:$true