Instalar a sua aplicação Do SharePoint Embedded para clientes

Este guia fornece instruções para programadores que procuram instalar a aplicação SharePoint Embedded (SPE) num inquilino que consome o Microsoft 365.

Pré-requisitos

Este guia pressupõe que criou um tipo de contentor do SharePoint Embedded e desenvolveu a sua aplicação. Saiba mais sobre os tipos de contentor.

O inquilino que consome pode ser qualquer inquilino do Microsoft 365 (incluindo o seu), mas tem de ter, pelo menos, uma licença do SharePoint.

Visão Geral

Os programadores que pretendem instalar a aplicação SharePoint Embedded num inquilino têm algumas tarefas para concluir:

• Obter as concessões de permissão de administrador necessárias para a sua aplicação no inquilino que está a consumir
• Registar o tipo de contentor da aplicação no inquilino que está a consumir
• Confirme que o inquilino do cliente concluiu a configuração de faturação pay as you go do SharePoint Embedded se o tipo de contentor estiver configurado para faturação pass-through

Permissões de aplicação para pedir

A sua aplicação precisa de um conjunto mínimo de permissões do Microsoft Graph para ser instalada num inquilino consumidor. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.

1. FileStorageContainerTypeReg.Selected permissões delegadas ou de aplicação para registar o tipo de contentor SPE no inquilino que está a consumir. Quando a aplicação utiliza a permissão delegada, o utilizador que executa o registo do tipo de contentor tem de ser um Administração Do SharePoint Embedded ou um Administração Global. A permissão da aplicação requer o consentimento do administrador, mas a permissão de delegado não requer o consentimento do administrador.
2. FileStorageContainer.Selected permissão delegada ou de aplicação para interagir com conteúdos do SharePoint Embedded para o tipo de contentor no inquilino que consome. Esta permissão requer o consentimento do administrador.

Pedir consentimento do administrador

As aplicações de inquilino único (quando a aplicação está registada e é utilizada no mesmo inquilino) podem beneficiar da obtenção do consentimento do administrador do Microsoft Entra administrador de diretórios de forma simplificada. Construa o URL de consentimento do administrador e forneça-o ao administrador do diretório Microsoft Entra para que este conceda o consentimento do administrador. Por exemplo:

https://login.microsoftonline.com/{tenant}/v2.0/adminconsent?client_id={client_id}&redirect_uri={redirect_uri}

Experiência de instalação na aplicação (recomendado)

Pode facilitar a instalação da sua aplicação SharePoint Embedded na sua própria experiência de aplicação. Recomendamos que utilize a Biblioteca de Autenticação da Microsoft (MSAL) para processar todos os passos de autorização. Eis o processo de alto nível:

1. Proporcionar uma experiência de início de sessão na sua aplicação e obter um token de ID para o utilizador
2. Inspecionar e validar o token para extrair o ID do inquilino e as funções atribuídas ao utilizador
3. Determinar se a aplicação já está instalada no inquilino
   1. Pedir um token de acesso do Microsoft Graph com FileStorageContainerTypeReg.Selected permissão de aplicação
   2. Tente obter o registo do seu tipo de contentor. Se o tipo de contentor já estiver registado no inquilino que está a consumir, já está!
4. Determine se o utilizador tem as funções Administrador de Função Privilegiada ou Administrador Global ao validar a wids afirmação no token de ID.
   1. Se o utilizador não for um Administração de Função Privilegiada ou um Administração Global, é pouco provável que possa dar consentimento do administrador nos seguintes passos.
5. Peça o consentimento do administrador para a sua aplicação ao navegar pelo utilizador para o URL de consentimento do administrador.
   1. Certifique-se de que o URI de redirecionamento da sua aplicação consegue processar este redirecionamento adequadamente para que possa prosseguir com os próximos passos na experiência da aplicação.
6. Assim que o consentimento do administrador for concedido, peça um token de acesso do Microsoft Graph com FileStorageContainerTypeReg.Selected permissão de aplicação
7. Criar o registo do tipo de contentor no inquilino que está a consumir
8. Se o tipo de contentor estiver configurado para faturação pass-through, deve fazer uma chamada à API faturável para confirmar que a faturação está configurada. Por exemplo, crie um contentor.
   1. Se a chamada falhar com um erro de faturação, aponte o utilizador para configurar a faturação pay as you go do SharePoint Embedded.