Тип ресурса riskyUser

  • Статья

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

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

Дополнительные сведения о событиях риска см. в разделе Защита идентификаторов Microsoft Entra.

Примечание.

  1. Для использования API riskyUsers требуется лицензия Microsoft Entra ID P2.
  2. Доступность рискованных данных пользователей регулируется политиками хранения данных Microsoft Entra.

Методы

Метод Тип возвращаемых данных Описание
Список коллекция riskyUser Получите список объектов riskyUser и их свойств.
Получение riskyUser Чтение свойств и связей объекта riskyUser .
Подтвердить скомпрометированный Нет Убедитесь, что один или несколько объектов RiskyUser скомпрометировались.
Dismiss Нет Отклоните риск, связанный с одним или несколькими объектами riskyUser .
Журнал списка коллекция riskyUserHistoryItem Получите riskyUserHistoryItems из свойства навигации журнала.

Свойства

Свойство Тип Описание
id String Уникальный идентификатор пользователя, подверженного риску.
isDeleted Логический Указывает, удален ли пользователь. Возможные значения: true, false.
IsProcessing Логический Указывает, обрабатывает ли серверная часть рискованное состояние пользователя.
riskLastUpdatedDateTime DateTimeOffset Дата и время последнего обновления опасного пользователя. Тип DateTimeOffset представляет сведения о дате и времени с использованием формата ISO 8601 и всегда указывает время в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
riskLevel riskLevel Уровень обнаруженного рискованного пользователя. Возможные значения: low, medium, high, hidden, none, unknownFutureValue.
riskState riskState Состояние риска пользователя. Возможные значения: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.
riskDetail riskDetail Возможные значения: none, , adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, adminConfirmedSigninSafeuserPerformedSecuredPasswordReset, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, hidden, adminConfirmedUserCompromised, unknownFutureValue, , adminConfirmedServicePrincipalCompromised, , adminDismissedAllRiskForServicePrincipal, m365DAdminDismissedDetection, userChangedPasswordOnPremises, adminDismissedRiskForSignIn, . adminConfirmedAccountSafe Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующее значение или значения в этом изменяемом перечислении: adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal, m365DAdminDismissedDetection, userChangedPasswordOnPremises, adminDismissedRiskForSignIn, . adminConfirmedAccountSafe
userDisplayName String Отображаемое имя пользователя с риском.
userPrincipalName String Имя участника-пользователя с риском.

Связи

Связь Тип Описание
история коллекция riskyUserHistoryItem Действие, связанное с изменением уровня риска пользователя

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.riskyUser",
  "id": "String (identifier)",
  "isDeleted": "Boolean",
  "isProcessing": "Boolean",
  "riskLastUpdatedDateTime": "String (timestamp)",
  "riskLevel": "String",
  "riskState": "String",
  "riskDetail": "String",
  "userDisplayName": "String",
  "userPrincipalName": "String"
}