Gerenciar o acesso a APIs protegidas pelo Microsoft Entra ID

Quando os desenvolvedores criam soluções de Estrutura do SharePoint, talvez precisem se conectar a uma API protegida pelo Microsoft Entra ID. Os desenvolvedores podem especificar quais aplicativos e permissões do Microsoft Entra sua solução requer e um administrador pode gerenciar a solicitação de permissão do acesso à API no centro de administração do SharePoint.

Saiba mais sobre como criar soluções de Estrutura do SharePoint que se conectam a APIs protegidas pelo Azure-AD.

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

A página de acesso à API mostra solicitações pendentes e aprovadas. Ele também mostra quais solicitações se aplicam a qualquer componente da Estrutura do SharePoint ou script personalizado em sua organização (em toda a organização) e quais solicitações 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 registradas no locatário, a função de administrador de aplicativos é 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 conectadas com a função de leitor global.

Aprovar uma solicitação pendente

  1. Selecione a solicitação e selecione Aprovar para ver detalhes sobre a solicitação.

  2. No painel Aprovar acesso , selecione Aprovar.

    O painel de acesso Aprovar

    Depois de aprovar uma solicitação, ela será movida para a lista de solicitações aprovadas.

    Observação

    As permissões do tipo delegado são adicionadas à Entidade de Aplicativo Web de Extensibilidade do 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 uma solicitação pendente

  1. Selecione a solicitação e selecione Rejeitar.

  2. Selecione Rejeitar novamente para confirmar.

    Rejeitar o acesso não remove o aplicativo do site Aplicativos. Se o aplicativo for usado em qualquer site, talvez ele não funcione conforme o esperado. Depois de rejeitar a solicitação, ela é removida da página e o desenvolvedor precisará emitir uma nova solicitação com o mesmo recurso e escopo.

Remover o acesso a uma solicitação aprovada anteriormente

  1. Selecione a solicitação e, em seguida, selecione Remover acesso.

  2. Selecione Remover novamente para confirmar.

    Quando você remove o acesso, as soluções e os scripts personalizados que dependem da permissão podem não funcionar conforme o esperado. Depois que você remover o acesso, a solicitação será removida da página e o desenvolvedor precisará emitir uma nova solicitação com o mesmo recurso e escopo.

Gerenciar o acesso usando o Microsoft PowerShell

Você também pode usar o PowerShell para gerenciar solicitações de permissão.