Visão geral das APIs de revisões de acesso

  • Artigo

Namespace: microsoft.graph

Use Microsoft Entra revisões de acesso para configurar revisões de acesso pontuais ou recorrentes para atestado do direito de acesso de uma entidade Microsoft Entra recursos. As entidades de segurança são usuários ou aplicativos (entidades de serviço). Os recursos Microsoft Entra incluem grupos, aplicativos (entidades de serviço), pacotes de acesso e funções privilegiadas. As revisões de acesso são um recurso de Microsoft Entra ID Governance.

Os cenários típicos do cliente para revisões de acesso incluem:

  • Os clientes podem examinar e certificar o acesso do usuário convidado a grupos por meio de associações de grupo. Os revisores podem usar os insights fornecidos para decidir com eficiência se os convidados devem ter acesso contínuo.
  • Os clientes podem examinar e certificar o acesso dos funcionários a recursos Microsoft Entra.
  • Os clientes podem examinar e auditar atribuições para Microsoft Entra ID funções privilegiadas. Isso dá suporte a organizações no gerenciamento de acesso privilegiado.

O locatário em que uma revisão de acesso está sendo criada ou gerenciada por meio da API deve ter licenças de compra ou avaliação suficientes. Para obter mais informações sobre os requisitos de licença, consulte Acesso revisa os requisitos de licença.

Observação

Este artigo descreve como exportar dados pessoais de um dispositivo ou serviço. Essas etapas podem ser usadas para dar suporte às suas obrigações de acordo com o GDPR (Regulamento Geral de Proteção de Dados). Os administradores de locatários autorizados podem usar o Microsoft Graph para corrigir, atualizar ou excluir informações identificáveis sobre usuários finais, incluindo perfis de usuário de clientes e funcionários ou dados pessoais, como nome do usuário, título de trabalho, endereço ou número de telefone, em seu ambiente Microsoft Entra ID.

Métodos

A tabela a seguir lista os métodos que você pode usar para interagir com recursos relacionados à revisão de acesso.

Método Tipo de retorno Descrição
Agendar definições
Definições de lista coleção accessReviewScheduleDefinition Obtenha uma lista dos objetos accessReviewScheduleDefinition e suas propriedades.
Criar definições accessReviewScheduleDefinition Crie um novo objeto accessReviewScheduleDefinition .
Obter accessReviewScheduleDefinition accessReviewScheduleDefinition Leia as propriedades e as relações de um objeto accessReviewScheduleDefinition .
Atualizar accessReviewScheduleDefinition accessReviewScheduleDefinition Atualize as propriedades de um objeto accessReviewScheduleDefinition .
Excluir accessReviewScheduleDefinition Nenhum Exclui um objeto accessReviewScheduleDefinition .
filterByCurrentUser coleção accessReviewScheduleDefinition Retorna todas as definições em que o usuário chamado é o revisor de quaisquer instâncias.
Instâncias
List instances coleção accessReviewInstance Obtenha uma lista dos objetos accessReviewInstance e suas propriedades.
Obter accessReviewInstance accessReviewInstance Leia as propriedades e as relações de um objeto accessReviewInstance .
stop Nenhum Parar manualmente um accessReviewInstance.
sendReminder Nenhum Envie um lembrete para os revisores de um accessReviewInstance.
resetDecisions Nenhum Redefine todos os itens de decisão em uma instância para notReviewed
applyDecisions Nenhum Aplicar manualmente a decisão em um accessReviewInstance.
acceptRecommendations Nenhum Permite que o usuário chamado aceite a recomendação de decisão para cada acesso NotReviewInstanceDecisionItem em que ele é o revisor para um acesso específicoReviewInstance.
batchRecordDecisions Nenhum Examine lotes de entidades ou recursos em uma única chamada.
filterByCurrentUser coleção accessReviewInstance Retorna todos os objetos de instância em uma definição para a qual o usuário chamado é o revisor.
Itens de decisão de instância
Listar decisões coleção accessReviewInstanceDecisionItem Obtenha uma lista dos objetos accessReviewInstanceDecisionItem e suas propriedades.
Obter accessReviewInstanceDecisionItem accessReviewInstanceDecisionItem Leia as propriedades e as relações de um objeto accessReviewInstanceDecisionItem .
Atualizar accessReviewInstanceDecisionItem accessReviewInstanceDecisionItem Atualize as propriedades de um objeto accessReviewInstanceDecisionItem .
accessReviewInstanceDecisionItem: filterByCurrentUser coleção accessReviewInstanceDecisionItem Retorna os itens de decisão dos quais o usuário chamador é o revisor.
Definições de histórico
Histórico de listaDefinições coleção accessReviewHistoryDefinition Obtenha uma lista dos objetos accessReviewHistoryDefinition e suas propriedades.
Criar historyDefinitions accessReviewHistoryDefinition Crie um novo objeto accessReviewHistoryDefinition .
Obter accessReviewHistoryDefinition accessReviewHistoryDefinition Leia as propriedades e as relações de um objeto accessReviewHistoryDefinition .
generateDownloadUri accessReviewHistoryInstance Gere um URI para uma instância que pode ser usada para recuperar dados de histórico de revisão.
List instances accessReviewHistoryInstance Recupere uma lista dos objetos accessReviewHistoryInstance e suas propriedades.

Verificações de autorização de função e de aplicativo

As funções de Microsoft Entra a seguir são necessárias para que um usuário chamado gerencie as revisões de acesso.

Operação Permissões de aplicativos Função de diretório necessária do usuário de chamada
Leitura AccessReview.Read.All ou AccessReview.ReadWrite.All Administrador global, leitor global, administrador de segurança, leitor de segurança ou administrador de usuário
Criar, Atualizar ou Excluir AccessReview.ReadWrite.All Administrador global ou administrador de usuário

Além disso, um usuário que é um revisor atribuído de uma revisão de acesso pode gerenciar suas decisões, sem precisar estar em uma função de diretório.

Conteúdo relacionado