Обзор 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 .