Instalar um aplicativo Embedded do SharePoint

Aplica-se a: Administrador de locatário consumidor — Administrador do SharePoint Embedded/Administrador global

Instale um aplicativo incorporado do SharePoint quando um locatário consumidor do Microsoft 365 precisar usar o aplicativo.

A instalação torna o aplicativo visível para administração de locatários, mas o locatário ainda pode precisar do consentimento do administrador, do registro de permissão de tipo de contêiner e da configuração de cobrança antes que os usuários possam acessar o conteúdo.

Este artigo se concentra no caminho do administrador do locatário consumidor no centro de administração do SharePoint.

Use este artigo com Escolha um modelo de aplicativo: locatário único ou multilocatário e as diretrizes de criação de aplicativo.

O modelo de aplicativo determina quem é o proprietário do aplicativo, quem o instala ou integra, onde os contêineres são criados, quem paga e quais administradores devem consentir ou configurar a cobrança.

Antes de começar

Confirme esses pré-requisitos.

• Você pode entrar no locatário consumidor.
• Sua conta tem a função de Administrador Integrado do SharePoint ou Administrador Global.
• O aplicativo SharePoint Embedded existe no locatário proprietário.
• Você tem a identidade do aplicativo ou o link de instalação fornecido pelo proprietário do aplicativo.
• Você sabe se a cobrança é feita pelo proprietário do aplicativo ou pela organização de usuário.
• Você sabe quais permissões o aplicativo solicita.
• Você poderá concluir o consentimento do administrador se o fluxo de instalação exigir.
• Você sabe se o aplicativo é um aplicativo de linha de negócios de locatário único ou um aplicativo ISV (fornecedor independente de software) multilocatário.

Para obter informações sobre a função, consulte Visão geral da Administração.

Entender o caminho do locatário consumidor

Um locatário consumidor é o locatário do Microsoft 365 onde os usuários executam o aplicativo SharePoint Embedded e onde o aplicativo armazena conteúdo em contêineres.

O administrador do locatário consumidor gerencia o aplicativo e os contêineres nesse locatário.

Para um aplicativo de linha de negócios de locatário único, o locatário proprietário e o locatário consumidor geralmente são os mesmos.

Para um aplicativo ISV multilocatário, cada locatário do cliente é um locatário consumidor e os arquivos do cliente permanecem no limite de locatário do Microsoft 365 do cliente.

Os administradores de locatários consumidores usam duas superfícies de administração.

Use o centro de administração do SharePoint quando precisar de instalação e validação guiadas.

Use o PowerShell para inventário e operações reproduzíveis após a instalação.

Instalar do Centro de Administração do SharePoint

Use a experiência de Aplicativos Incorporados do SharePoint no Centro de Administração do SharePoint quando o aplicativo estiver disponível para instalação.

A guia Aplicativos instalados lista os aplicativos incorporados do SharePoint criados por sua organização e por organizações externas.

1. Entre no Centro de administração do SharePoint.
2. Na navegação à esquerda, expanda SharePoint Embedded.
3. Selecione Aplicativos.
4. Examine os aplicativos instalados para confirmar se o aplicativo já está instalado.
5. Se você for o proprietário do aplicativo, examine Aplicativos de propriedade e localize o aplicativo.
6. Selecione a ação de instalação disponível para o aplicativo.
7. Revise o nome do aplicativo, o editor e as informações de cobrança.
8. Continue com os prompts de instalação.
9. Conclua o consentimento do administrador se o fluxo direcionar você ao consentimento.
10. Conclua a instalação.

Os prompts de instalação exatos podem variar de acordo com a propriedade do aplicativo e o modelo de cobrança.

Não continue se a identidade ou o fornecedor do aplicativo for inesperado.

Instalar um aplicativo de propriedade que não foi instalado

Um fluxo de criação bem-sucedido instala o aplicativo automaticamente, portanto, você normalmente não instala um aplicativo próprio separadamente.

Somente quando a etapa de instalação no fluxo de criação falha, o aplicativo SharePoint Embedded é criado, mas não instalado.

Nesse caso, instale o aplicativo na guia Aplicativos próprios .

1. Vá paraAplicativos Incorporados >do SharePoint.
2. Abra Aplicativos com propriedade.
3. Localize o aplicativo que não está instalado.
4. Selecione a ação de instalação do aplicativo.
5. Conclua os prompts de instalação.

Após a conclusão da instalação, o aplicativo aparecerá na guia Aplicativos instalados .

Validar instalação

Após a instalação, valide o inventário do aplicativo.

1. Retorne aaplicativosincorporados> do SharePoint.
2. Abra Aplicativos instalados.
3. Confirme se o aplicativo está listado.
4. Confirme o nome e o fornecedor do aplicativo.
5. Confirme o tipo de cobrança e o status da cobrança.
6. Se o aplicativo pertencer à sua organização, abra Aplicativos de propriedade e confirme os metadados de propriedade.
7. Registre a ID do aplicativo proprietário para futura revisão de permissão e do PowerShell.

Selecione um aplicativo na guia Aplicativos instalados para abrir seu painel de detalhes. O painel mostra o status do aplicativo, a ID do aplicativo Microsoft Entra ID, a ID do aplicativo do SharePoint Embedded, o fornecedor e as informações de cobrança.

Se o aplicativo não estiver visível, atualize a página e confirme se a instalação foi concluída com êxito.

Se o aplicativo permanecer ausente, entre em contato com o proprietário do aplicativo e verifique a identidade do aplicativo.

Consentimento administrativo completo

Instalação e consentimento estão relacionados, mas nem sempre são a mesma tarefa.

O aplicativo proprietário deve ter uma entidade de serviço instalada no locatário consumidor e o consentimento do administrador antes de registrar permissões de aplicativo de tipo de contêiner.

Use Conceder consentimento e permissões de administrador para examinar as permissões solicitadas e o consentimento completo.

O consentimento do administrador da Administração pode ser solicitado por meio do ponto de extremidade do consentimento do administrador da plataforma de identidade da Microsoft, por exemplo:

https://login.microsoftonline.com/{your-tenant-id}/v2.0/adminconsent?client_id={owning-app-clientid}&scope=https://graph.microsoft.com/.default&redirect_uri={spe-app-redirect-uri}

Use a ID de cliente exata fornecida pelo proprietário do aplicativo. Não substitua por uma ID de aplicativo diferente.

Confirmar requisitos de cobrança

O SharePoint Embedded dá suporte a modelos de cobrança padrão e de passagem.

Para cobrança de passagem, um Administrador Global no locatário consumidor deve configurar a cobrança no Centro de administração do Microsoft 365 antes que os usuários possam acessar o aplicativo. Somente um Administrador Global pode configurar o faturamento; a função de Administrador Integrado do SharePoint não pode.

Se a cobrança for inválida ou o SharePoint Embedded estiver desativado, os usuários não poderão mais criar novos contêineres, embora os contêineres existentes e seu conteúdo permaneçam acessíveis.

Anexar ou alterar a cobrança no painel de detalhes

Se a cobrança foi ignorada durante a criação do aplicativo, você poderá anexá-la posteriormente no painel de detalhes do aplicativo na guia Aplicativos instalados . Para um aplicativo da organização Proprietário que sua organização possui, você também pode alterar a assinatura de cobrança que já está anexada no mesmo painel.

1. Abraaplicativosinstalados de aplicativos >incorporados>do SharePoint.
2. Selecione o aplicativo para abrir seu painel de detalhes.
3. Em Informações de cobrança, anexe uma assinatura de cobrança ou atualize a existente.

Para um aplicativo de organização de usuário , a cobrança não é anexada a este painel. Um Administrador Global no locatário consumidor configura a cobrança no Centro de administração do Microsoft 365. Consulte Configurar cobrança no Centro de administração do Microsoft 365.

Use Configurar cobrança no Centro de administração do Microsoft 365 para configurar a cobrança para cenários de locatário consumidor.

Use Monitorar uso, cobrança e custo para revisar o custo contínuo.

Verificar contêineres após o uso do aplicativo

O aplicativo não pode criar contêineres até que os usuários ou processos de aplicativo comecem a usá-lo. Depois que os contêineres existirem, valide-os.

1. No Centro de Administração do SharePoint, acesseContêineres Ativos do SharePoint Embedded>.
2. Pesquise ou filtre por nome do aplicativo.
3. Abra um painel de detalhes do contêiner.
4. Revise os metadados gerais.
5. Revise a associação.
6. Confirme o estado do rótulo de confidencialidade se os rótulos forem necessários.
7. Examine o uso do armazenamento.

Para obter etapas detalhadas, consulte Gerenciar contêineres no Centro de administração do SharePoint.

Validar com o PowerShell

Use o Shell de Gerenciamento do SharePoint Online quando precisar de uma verificação com marca.

Instale o Shell de Gerenciamento do SharePoint Online mais recente e conecte-se ao SharePoint Online.

Em seguida, use os cmdlets de inventário de aplicativos com suporte.

Get-SPOApplication

Para exibir detalhes de um aplicativo específico, use a ID do aplicativo proprietário.

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

Para obter detalhes de comando, consulte Gerenciar contêineres com o PowerShell e Get-SPOApplication.

Gerenciar registros de tipo de contêiner com o Microsoft Graph

Os administradores de locatários consumidores também podem gerenciar registros de tipo de contêiner programaticamente. O recurso fileStorageContainerTypeRegistration representa o registro de um tipo de contêiner em um locatário consumidor. A FileStorageContainerTypeReg.Selected permissão delegada é suficiente para registros pertencentes ao aplicativo de chamada. O gerenciamento de todos os registros no locatário requer a FileStorageContainerTypeReg.Manage.All permissão delegada.

Solucionar problemas de instalação

Use essas verificações quando a instalação não for concluída.

• Confirme se o administrador tem a função de Administrador Integrado do SharePoint.
• Confirme a identidade e o fornecedor do aplicativo.
• Confirme se o aplicativo está disponível para seu locatário.
• Confirme se o consentimento do administrador foi concedido para o aplicativo correto.
• Confirme se o aplicativo tem uma entidade de serviço no locatário consumidor após o consentimento.
• Confirme se a cobrança está ativa para aplicativos de passagem.
• Confirme as permissões de aplicativo do tipo de contêiner registrado do proprietário do aplicativo quando necessário.
• Confirme se os usuários recebem as funções de aplicativo ou associações necessárias.

Conteúdo relacionado

• Visão Geral do Administrador
• Criar aplicativos no Centro de administração do SharePoint
• Conceder consentimento e permissões do administrador
• Configurar a cobrança no Centro de administração do Microsoft 365
• Gerenciar contêineres no Centro de Administração do SharePoint

Próximas etapas

Conceder consentimento e verificar permissões em Conceder consentimento e permissões de administrador.