Configurar um ambiente para aplicativos do SharePoint Server

APLICA-SE A:2013 2019 Subscription Edition SharePoint no Microsoft 365

Para permitir que os usuários instalem e usem aplicativos para o SharePoint em seus sites, configure seu ambiente para dar suporte a eles. Este artigo descreve como configurar seu ambiente para suportar aplicativos. Use o artigo Plano para aplicativos do SharePoint Server para analisar opções e determinar os valores a serem usados para definir configurações neste artigo.

Saiba mais sobre como gerenciar aplicativos usando o Catálogo de Aplicativos para SharePoint no Microsoft 365.

Antes de começar

• Compre um nome de domínio de um provedor de nomes de domínio para seus aplicativos, por exemplo, ContosoApps.com.

• Verifique se você é membro do grupo Administradores do Farm para executar as etapas deste artigo. Para realizar algumas etapas, você também precisa ser um administrador de domínio.

• Se você tiver um ambiente de vários locatários, precisará executar algumas etapas usando o Microsoft PowerShell. Verifique se você tem permissões para administrar o SharePoint Server usando o Windows PowerShell.

Configurar os nomes de domínio no DNS

Você deve configurar um novo domínio em serviços de nomes de domínio (DNS) para hospedar os aplicativos. Para melhorar a segurança, o nome de domínio não deve ser um subdomínio do domínio que hospeda os sites do SharePoint Server. Por exemplo, se os sites do SharePoint Server estiverem em Contoso.com, considere ContosoApps.com em vez de App.Contoso.com como o nome de domínio.

Quando um aplicativo é provisionado, ele provisiona um nome de domínio DNS exclusivo (por exemplo, Apps- 12345678ABCDEF.ContosoApps.com, em que 12345678ABCDEF é um identificador exclusivo para o aplicativo). Você precisa de uma entrada CNAME (Nome Canônico) curinga para que o domínio DNS dê suporte a esses nomes exclusivos.

Dependendo da sua configuração, (por exemplo, se você estiver usando pesquisa direta WINS), você pode precisar criar primeiro uma nova zona de pesquisa direta, ou começar com a entrada do curinga CNAME na mesma zona que o domínio do site do SharePoint Server. Nos procedimentos a seguir, você criará uma zona de pesquisa direta e depois um registro de alias curinga para o nome de domínio DNS que permite que aplicativos individuais criem nomes de domínio únicos dentro do domínio de aplicativo. Nesses procedimentos, usamos o Gerenciador DNS para Windows Server 2012 R2. Se você possui um tipo diferente de servidor DNS, siga os procedimentos na documentação para esse tipo de servidor.

Para criar uma zona de pesquisa direta para o nome de domínio do aplicativo

1. Verifique se a conta de usuário que executa esse procedimento é um administrador de domínio no controlador de domínio.

2. Clique em Iniciar, aponte para Ferramentas Administrativas e clique em DNS.

3. No Gerenciador de DNS, clique com o botão direito em Zonas de Pesquisa Direta e em Nova Zona….

4. No Assistente de Nova Zona, clique em Avançar.

5. Na página Tipo de Zona,aceite o padrão de Zona primária e clique em Avançar.

6. Na página Escopo de Replicação de Zona do Active Directory, selecione o método de replicação adequado para seu ambiente (o padrão é Para todos os servidores DNS neste domínio) e clique em Avançar.

7. Na página Nome da Zona, na caixa Nome da Zona digite o nome do novo domínio de aplicativo (por exemplo, ContosoApps.com) e clique em Avançar.

8. Na página Atualização Dinâmica, selecione o tipo adequado de atualizações dinâmicas para seu ambiente (o padrão é Não permitir atualizações dinâmicas) e clique em Avançar.

9. Na página Concluindo o Assistente de Nova Zona, revise as configurações e clique em Concluir.

Agora, você acaba de criar uma zona de pesquisa direta (e um nome de domínio) para usar para os aplicativos no seu ambiente.

Para criar um registro de Alias (CNAME) curinga para o novo nome de domínio

1. Verifique se a conta de usuário que executa esse procedimento é um administrador de domínio no controlador de domínio.

2. No Gerenciador DNS, em Zonas de Pesquisa Direta, clique com o botão direito no novo nome do domínio de aplicativo e clique em Novo Alias (CNAME).

3. Na caixa de diálogo Novo Registro de Recursos, na caixa Nome do Alias (usa domínio pai se deixado em branco), digite *.

   A caixa Nome de domínio totalmente qualificado (FQDN) exibe *. seguido do nome de domínio que você criou para os aplicativos. Por exemplo, *.ContosoApps.com ou *.Contoso-Apps.com.

4. Ao lado da caixa Nome de domínio totalmente qualificado (FQDN) para o host de destino, digite o FQDN do servidor que hospeda os sites do SharePoint Server.

   Por exemplo, SharePoint.Contoso.com.

   Ou:

5. Ao lado da caixa Nome de domínio totalmente qualificado (FQDN) para o host de destino, clique em Procurar e navegue até a Zona de pesquisa direta do domínio que hospeda os sites do SharePoint Server.

   Por exemplo, Contoso.com.

6. E em seguida navegue até o registro que aponta para o servidor que hospeda o site do SharePoint Server.

   Por exemplo, SharePoint.

   A caixa de diálogo Novo Registro de Recursos mostra o alias curinga para o domínio do aplicativo e o FQDN do servidor que hospeda os sites do SharePoint.

   

7. Clique em OK.

Você pode verificar o novo nome de domínio e alias executando o ping neles.

Para verificar o novo nome de domínio

1. Verifique se a conta de usuário que está realizando esse procedimento é administrador de domínio no controlador de domínio.

2. Clique em Iniciar e clique em Prompt de Comando.

3. No prompt de comando, digite ping, seguido por um subdomínio do domínio que você criou e pressione ENTER.

   Por exemplo, ping Apps-12345678ABCDEF.contosoapps.com

   Se o comando ping retornar o endereço de IP correto, então seu curinga para o nome do domínio foi configurado com sucesso.

Como criar um novo certificado SSL curinga

Se você estiver usando o Secure Sockets Layer (SSL) para os sites SharePoint Server em seu ambiente ou se você usa algum aplicativo que usa dados externos aos sites do SharePoint Server, você deve usar SSL para seu aplicativo. Para usar SSL, você cria um certificado SSL para seu domínio de aplicativo (por exemplo, ContosoApps.com).

O domínio deve ser adicionado no formato de um curinga (por exemplo, *.ContosoApps.com). Você precisa de um certificado curinga em vez de certificados individuais, porque cada aplicativo instalado tem seu próprio subdomínio.

Para permitir o suporte para descarregamento de SSL com domínios de aplicativo do SharePoint Server, habilite o suporte para vários domínios de aplicativo usando os seguintes comandos do Microsoft PowerShell:

$contentService = [Microsoft.SharePoint.Administration.SPWebService]::ContentService
$contentService.SupportMultipleAppDomains = $true
$contentService.Update()
iisreset

Como configurar os aplicativos de serviços das Configurações de Assinatura e do Gerenciamento de Aplicativo

Os aplicativos se apoiam nos aplicativos de serviço do Gerenciamento do Aplicativo e das Configurações de Assinatura do Microsoft SharePoint Foundation. Use os procedimentos a seguir para configurá-los.

Para ativar o Serviço de Configurações de Assinatura do Microsoft SharePoint Foundation

1. No Administração Central, em Configurações do Sistema, clique em Gerenciar serviços neste farm.

2. Para o Serviço de Configurações de Inscrição do Microsoft SharePoint Foundation, clique em Habilitar Provisionamento Automático

Em seguida, crie um aplicativo e um proxy de serviço configurações de assinatura usando o Microsoft PowerShell. Use o script de exemplo fornecido em New-SPSubscriptionSettingsServiceApplication.

Também é necessário um aplicativo de serviço de Gerenciamento de Aplicativos. Os procedimentos a seguir fornecem as etapas para configurá-lo.

Para criar um aplicativo de serviço de Gerenciamento de Aplicativos

1. Em Administração Central, sob Gerenciamento de aplicativos, clique em Gerenciar aplicativos de serviço.

2. Clique em Novo e em Serviço de Gerenciamento de Aplicativos.

3. Digite um nome para o aplicativo de serviço na caixa Nome do Aplicativo de Serviço.

4. Em Pool de Aplicativos, escolha Padrão do SharePoint Web Services na lista Usar de pool de aplicativos existente.

5. Clique em OK.

Especifique o domínio e o prefixo de aplicativo

Nesta seção, você pode especificar o domínio e o prefixo de aplicativo a serem usados para aplicativos em seu ambiente. A URL do aplicativo aponta para o domínio de aplicativo e um prefixo que determina como cada aplicativo será nomeado.

Use o procedimento a seguir para configurar URLs de aplicativos.

Para configurar URLs de aplicativos

1. No Administração Central, clique em Aplicativos.

2. Na página Aplicativos, clique em Configurar URLs de Aplicativos.

3. Na caixa Domínio de Aplicativo, digite o domínio isolado que você criou para aplicativos de hospedagem (por exemplo, ContosoApps.com).

4. Na caixa Prefixo de aplicativo, digite o nome a ser usado para o prefixo de URL dos aplicativos.

   (Por exemplo, você poderia usar "apps" como o prefixo e veria uma URL para cada aplicativo, como "apps- 12345678ABCDEF.ContosoApps.com".)

5. Clique em OK.

6. Se você instalar aplicativos e tiver alterado o prefixo de aplicativo (também conhecido como nome da assinatura do site), deverá executar mais etapas que envolvem a reinicialização do Serviço de Publicação Web (SERVIÇO WWW) que hospeda os aplicativos.

   Importante

   Reiniciar o Serviço WWW também irá reiniciar o serviço de Administração do IIS e o Serviço de Ativação de Processos do Windows. Também irá desativar todos os sites e aplicativos que dependem desses serviços e eles podem perder o estado existente e ficarão indisponíveis até que os serviços sejam reiniciados com êxito. Você deve planejar a execução dessas etapas durante um horário de manutenção programada. > Para concluir as tarefas de renomeação de prefixo de aplicativo, execute estas etapas: > Parar o serviço de Temporizador do SharePoint. > Reinicie o World Wide Web Publishing Service que hospeda os aplicativos. > Inicie o serviço timer do SharePoint.

Configurações de vários locatários (opcional)

Se você hospeda vários locatários no ambiente, deve usar o Microsoft PowerShell para configurar URLs de aplicativos para cada locatário. Use o procedimento a seguir para configurá-los.

Para configurar URLs de aplicativo usando o Windows PowerShell

1. Abra o Shell de Gerenciamento do SharePoint.

2. No prompt de comando do Microsoft PowerShell, digite os comandos a seguir e pressione ENTER depois de cada um:

   Set-SPAppDomain <appDomain>
   
   Set-SPAppSiteSubscriptionName -Name "app" -Confirm:$false
   

   Em que:

   • <appDomain> é o nome de domínio que você criou.

3. Se você for instalar aplicativos e precisar mudar o prefixo do aplicativo (também chamado de nome de assinatura do site), você deve executar as etapas adicionais que envolvem reiniciar o Serviço de Publicação na World Wide Web (Serviço WWW) que hospeda os aplicativos.

   Importante

   Reiniciar o Serviço WWW também irá reiniciar o serviço de Administração do IIS e o Serviço de Ativação de Processos do Windows. Também irá desativar todos os sites e aplicativos que dependem desses serviços e eles podem perder o estado existente e ficarão indisponíveis até que os serviços sejam reiniciados com êxito. Você deve planejar a execução dessas etapas durante um horário de manutenção programada. > Para concluir as tarefas de renomeação de prefixo de aplicativo, execute estas etapas: > Parar o serviço de Temporizador do SharePoint. > Reinicie o World Wide Web Publishing Service que hospeda os aplicativos. > Inicie o serviço timer do SharePoint.

Para saber mais, veja Set-SPAppSiteSubscriptionName e Set-SPAppDomain.

Recurso Configure os pontos de extremidade voltados para a Internet (Opcional)

O Repositório do SharePoint contém aplicativos para SharePoint destinados ao uso com sites que requerem pontos de extremidade voltados para a Internet. Por padrão, esses aplicativos não estão disponíveis (na cor cinza e não podem ser comprados) porque são incompatíveis com a maioria dos sites. Porém, se seu farm estiver configurado para permitir pontos de extremidade voltados para a Internet, você pode ativar o recurso de pontos de extremidade voltados para a Internet para exibir esses aplicativos no Repositório do SharePoint. Você ativa esse recurso na Administração Central.

Para configurar os pontos de extremidade voltados para a internet para os aplicativos

1. Em Administração Central, clique em Gerenciamento de Aplicativo.

2. Na página Gerenciamento de Aplicativos, clique em Gerenciar Aplicativos Web.

3. Na página Gerenciar Aplicativos Web, selecione o aplicativo Web que deseja alterar.

4. Na faixa de opções, clique em Gerenciar Recursos.

5. Na lista de recursos, vá para Aplicativos que necessitam de pontos de extremidade voltados para a internet , clique em Ativar.

6. Clique em OK.

Em alguns casos, por exemplo, quando você tem um farm do SharePoint Server local em que atualizações são raramente instaladas, você precisará executar um cmdlet para atualizar a URL usada para apontar para o Repositório do SharePoint:

Set-SPAppStoreConfiguration -Url http://office.microsoft.com -Enable $true

Confira também

Conceitos

Plano para aplicativos do SharePoint Server

Instalação e gerenciamento de aplicativos do SharePoint Server