Visão geral das APIs de revisões de acesso
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
- Passe por tutoriais guiados para saber como usar a API de revisões de acesso para examinar o acesso a recursos Microsoft Entra.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de