Тип ресурса riskyUser

Статья
03/10/2024

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

Примечание.

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

Методы

Метод	Возвращаемый тип	Описание
Список рискованныхпользователей	коллекция riskyUser	Перечисление пользователей, подверженных риску, и их свойств.
Получить riskyUser	riskyUser	Получение определенного рискованной пользователя и его свойств.
Журнал списка	коллекция riskyUserHistoryItem	Получение журнала рисков пользователя Microsoft Entra.
Подтверждение компрометации riskyUsers	Нет	Подтвердите компрометацию пользователя, который рискует скомпрометирован.
Уволить рискованных Пользователей	Нет	Отклоните риск рискованных пользователей.

Свойства

Свойство	Тип	Описание
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"
}