Обзор 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 журналы аудита: требования к лицензиям и роли.

Связанные материалы

• Начните работать со следующими ресурсами, представляющими различные отчеты о действиях:
  • тип ресурса directoryAudit .
  • Тип ресурса signIn.
  • тип ресурса provisioningObjectSummary .