Compartilhar via

Gerir o acesso a APIs protegidas por Microsoft Entra ID

Quando os programadores criam soluções Estrutura do SharePoint, poderão ter de se ligar a uma API protegida através de Microsoft Entra ID. Os programadores podem especificar as Microsoft Entra aplicações e permissões necessárias para a respetiva solução e um administrador pode gerir o pedido de permissão a partir do acesso à API no centro de administração do SharePoint.

Saiba mais sobre a criação de soluções Estrutura do SharePoint que se ligam a APIs protegidas pelo Azure-AD.

A página de acesso à API no centro de administração do SharePoint moderno

A página de acesso à API mostra pedidos pendentes e aprovados. Também mostra que pedidos se aplicam a qualquer componente Estrutura do SharePoint ou script personalizado na sua organização (em toda a organização) e que pedidos se aplicam apenas ao componente específico (isolado).

Observação

A função de administrador necessária para aprovar permissões depende da API. Para aprovar permissões para qualquer uma das APIs de terceiros registadas no inquilino, a função de administrador da aplicação é suficiente. Para aprovar permissões para o Microsoft Graph ou qualquer outra API da Microsoft, é necessária a função de Administrador Global. A página de acesso à API não está disponível para pessoas com sessão iniciada com a função de leitor global.

Aprovar um pedido pendente

  1. Selecione o pedido e, em seguida, selecione Aprovar para ver detalhes sobre o pedido.

  2. No painel Aprovar acesso , selecione Aprovar.

    O painel Aprovar acesso

    Depois de aprovar um pedido, este muda para a lista Pedidos aprovados.

    Observação

    As permissões do tipo delegado são adicionadas ao Principal de Aplicação Web de Extensibilidade de Cliente do SharePoint Online no Microsoft Entra ID.

    Se você tentar aprovar uma solicitação de permissão para um recurso que já tenha algumas permissões concedidas (por exemplo, conceder permissões adicionais para o Microsoft Graph), os escopos solicitados serão adicionados às permissões concedidas anteriormente.

Rejeitar um pedido pendente

  1. Selecione o pedido e selecione Rejeitar.

  2. Selecione Rejeitar novamente para confirmar.

    Rejeitar o acesso não remove a aplicação do site Aplicações. Se a aplicação for utilizada em sites, poderá não funcionar conforme esperado. Depois de rejeitar o pedido, este é removido da página e o programador terá de emitir um novo pedido com o mesmo recurso e âmbito.

Remover o acesso a um pedido aprovado anteriormente

  1. Selecione o pedido e, em seguida, selecione Remover acesso.

  2. Selecione Remover novamente para confirmar.

    Quando remove o acesso, as soluções e os scripts personalizados que dependem da permissão podem não funcionar conforme esperado. Depois de remover o acesso, o pedido é removido da página e o programador terá de emitir um novo pedido com o mesmo recurso e âmbito.

Gerir o acesso com o Microsoft PowerShell

Também pode utilizar o PowerShell para gerir pedidos de permissão.