Тип ресурса riskyUser
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет пользователей Microsoft Entra, которые подвергаются риску. Microsoft Entra ID Protection постоянно оценивает риски пользователей на основе различных сигналов и машинного обучения. Этот API предоставляет программный доступ всем пользователям, подверженным риску, в клиенте Microsoft Entra.
Дополнительные сведения о событиях риска см. в разделе Защита идентификаторов Microsoft Entra.
Примечание.
- Для использования API riskyUsers требуется лицензия Microsoft Entra ID P2.
- Доступность рискованных данных пользователей регулируется политиками хранения данных Microsoft Entra.
Методы
| Метод | Возвращаемый тип | Описание |
|---|---|---|
| Список | коллекция riskyUser | Перечисление пользователей, подверженных риску, и их свойств. |
| Получение | riskyUser | Получение определенного рискованной пользователя и его свойств. |
| Подтвердить скомпрометированный | Нет | Подтвердите компрометацию пользователя, который рискует скомпрометирован. |
| Dismiss | Нет | Отклоните риск рискованных пользователей. |
| Журнал списка | коллекция riskyUserHistoryItem | Получение журнала рисков пользователя Microsoft Entra. |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| 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 | Имя участника-пользователя с риском. |
Связи
Отсутствуют.
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "Boolean",
"isDeleted": "Boolean",
"riskDetail": "string",
"riskLevel": "string",
"riskState": "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}