Compartilhar via


Visão geral da API de relatórios de atividades

Namespace: microsoft.graph

Microsoft Entra ID rastreia a atividade do usuário e cria relatórios que ajudam você a entender como seus usuários acessam e usam serviços Microsoft Entra. Use o Microsoft API do Graph para Microsoft Entra ID analisar os dados nesses relatórios e criar soluções personalizadas personalizadas para as necessidades específicas da sua organização.

A disponibilidade desses relatórios de atividades é regida pelas políticas de retenção de dados Microsoft Entra. Para saber mais, confira políticas de retenção de dados.

O que são Microsoft Entra logs de atividades?

Microsoft Entra ID fornece os seguintes tipos de relatórios de atividades:

  • Auditorias de diretório
  • Entradas

Auditorias de diretório

O relatório de auditoria de diretório fornece acesso ao histórico de todas as tarefas executadas em seu locatário. O relatório de auditoria de diretório fornece registros de atividades do sistema para conformidade. Entre outros benefícios, os dados fornecidos permitem que você aborde cenários comuns, como:

  • Quem concedeu acesso ao grupo de administradores a um usuário de diretório?
  • Quais usuários estão se conectando a um aplicativo adquirido recentemente?
  • Quantas redefinições de senhas foram feitas no diretório?

Entradas

O relatório de entradas ajuda a determinar quem executou as tarefas relatadas pelas auditorias de diretório. O relatório de entrada ajuda você a responder a perguntas como:

  • O que é o padrão de entrada de um usuário?
  • Quantos usuários entraram durante a semana passada?
  • Qual é o status dessas entradas?

O que posso fazer com as APIs de log de auditoria no Microsoft Graph?

As seguintes solicitações são populares para trabalhar com dados de log de auditoria:

Operation URL
OBTER atividades de usuário do locatário OBTER https://graph.microsoft.com/v1.0/auditLogs/directoryAudits
OBTER entradas de usuário do locatário OBTER https://graph.microsoft.com/v1.0/auditLogs/signIns

Requisitos de licença

Os relatórios de atividades estão disponíveis para os recursos que você licenciou. Se você possui uma licença para um recurso específico, também tem acesso aos relatórios. Para obter mais informações sobre os requisitos de licença para os diferentes relatórios de atividade, consulte Microsoft Entra logs de auditoria: requisitos de licença e função.