Поделиться через


Обзор API отчетов об активности

Пространство имен: microsoft.graph

Microsoft Entra ID отслеживает действия пользователей и создает отчеты, помогающие понять, как пользователи получают доступ к Microsoft Entra службам и используют их. Используйте API Graph Майкрософт для Microsoft Entra ID для анализа данных в этих отчетах и создания пользовательских решений, адаптированных к конкретным потребностям вашей организации.

Доступность этих отчетов о действиях регулируется политиками хранения данных Microsoft Entra. Подробнее см. в статье Политики хранение данных.

Что такое журналы действий Microsoft Entra?

Microsoft Entra ID предоставляет следующие типы отчетов о действиях:

  • Аудиты каталога
  • Входы

Аудиты каталога

Отчет аудитов каталога предоставляет доступ к истории всех выполненных задач в клиенте. Отчет аудитов каталога предоставляет записи о действиях системы для обеспечения соответствия требованиям. Помимо прочего, предоставляемые данные позволяют рассматривать типичные сценарии, например:

  • Кто предоставил доступ группе администраторов к каталогу пользователя?
  • Какие пользователи входят в недавно приобретенное приложение?
  • Сколько сбросов паролей выполнено в каталоге?

Входы

Отчет о входах помогает определить, кто выполнял задачи, указанные в отчетах аудитов каталога. Отчет о входах помогает ответить на представленные ниже вопросы.

  • Какой шаблон входа использует пользователь?
  • Сколько пользователей выполнило вход за прошлую неделю?
  • Какое состояние у этих входов?

Как можно использовать API журнала аудита в Microsoft Graph?

Ниже приведены популярные запросы для работы с данными журнала аудита.

Operation URL-адрес
Получение действий пользователей клиента GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits
Получение входов пользователей клиента GET https://graph.microsoft.com/v1.0/auditLogs/signIns

Требования лицензирования

Отчеты об активности доступны для компонентов, на которые у вас есть лицензии. Если у вас есть лицензия на определенный компонент, вам будет предоставлен доступ к соответствующим отчетам. Дополнительные сведения о требованиях к лицензиям для различных отчетов о действиях см. в разделе Microsoft Entra журналы аудита: требования к лицензиям и роли.