Защита идентификации Microsoft Entra

Защита идентификации — это средство, позволяющее организациям обнаруживать, исследовать и устранять риски на основе удостоверений в их среде.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Microsoft
URL	https://azure.microsoft.com/
Адрес электронной почты	azuresentinel@microsoft.com

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://www.microsoft.com
Политика конфиденциальности	https://privacy.microsoft.com/en-us/privacystatement
Категории	Веб-сайт

Защита идентификации — это средство, позволяющее организациям обнаруживать, исследовать и устранять риски на основе удостоверений в их среде. Этот соединитель будет использовать API riskyUsers, riskDetections и signIns.

Pre-requisites

Защита идентификаторов Microsoft Entra — это функция ценовой категории "Премиум". Для доступа к API riskDetection требуется лицензия Microsoft Entra ID P1 или P2 (примечание. Лицензии P1 получают ограниченные сведения о рисках). API riskyUsers доступен только для лицензий Microsoft Entra ID P2.

Документация по API

https://docs.microsoft.com/en-us/graph/api/resources/identityprotectionroot?view=graph-rest-1.0

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Подтверждение рискованного пользователя как скомпрометированного	Подтверждение рискованного пользователя как скомпрометированного
Получение журнала рисков для рискованных пользователей	Получение журнала рисков
Получение обнаружения рисков	Получение рисков
Получение рискованного пользователя	Получение определенного рискованного пользователя и его свойств
Увольнение рискованного пользователя	Увольнение рискованного пользователя

Подтверждение рискованного пользователя как скомпрометированного

Идентификатор операции:: ConfirmRiskUser

Подтверждение рискованного пользователя как скомпрометированного

Параметры

Имя	Ключ	Обязательно	Тип	Описание
userIds	userIds		array of string

Получение журнала рисков для рискованных пользователей

Идентификатор операции:: GetRiskUserHistory

Получение журнала рисков

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Получение риска журнала для пользователя	Id	True	string	Идентификатор пользователя или имя участника-пользователя

Возвращаемое значение

Представляет журнал рисков пользователя Идентификатора Microsoft Entra, определяемого защитой идентификатора Microsoft Entra ID

Тело: Get_risk_history

Получение обнаружения рисков

Идентификатор операции:: riskDetections

Получение рисков

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Получение обнаружения рисков	Id	True	string	Идентификатор пользователя или имя участника-пользователя

Возвращаемое значение

Этот API предоставляет программный доступ ко всем обнаружениям рисков в среде идентификатора Microsoft Entra

Тело: Get_riskDetection

Получение рискованного пользователя

Идентификатор операции:: GetRiskUser

Получение определенного рискованного пользователя и его свойств

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Получение пользователя риска	Id	True	string	Идентификатор пользователя или имя участника-пользователя

Возвращаемое значение

Получение результата пользователя риска

Тело: Get_Risk_User_Result

Увольнение рискованного пользователя

Идентификатор операции:: DismissRiskUser

Увольнение рискованного пользователя

Параметры

Имя	Ключ	Обязательно	Тип	Описание
userIds	userIds		array of string

Определения

Get_Risk_User_Result

Получение результата пользователя риска

Имя	Путь	Тип	Описание
@@odata.context	@@odata.context	string
id	id	string	Уникальный идентификатор пользователя, подверженного риску
isDeleted	isDeleted	boolean	Указывает, удаляется ли пользователь. Возможные значения: true, false
isProcessing	isProcessing	boolean	Указывает, обрабатывается ли рискованное состояние пользователя серверной частью
riskLevel	riskLevel	string	Уровень обнаруженного рискованного пользователя
riskState	riskState	string	Дата и время последнего обновления рискованных пользователей
riskDetail	riskDetail	string	Сведения об обнаруженной опасности
riskLastUpdatedDateTime	riskLastUpdatedDateTime	string	Дата и время последнего обновления рискованных пользователей.
ИмяПользователя	userDisplayName	string	Отображаемое имя пользователя рискованного пользователя
userPrincipalName	userPrincipalName	string	Имя субъекта-пользователя рискованного пользователя

Get_riskDetection

Этот API предоставляет программный доступ ко всем обнаружениям рисков в среде идентификатора Microsoft Entra

Имя	Путь	Тип	Описание
@@odata.type	@@odata.type	string
id	id	string	Уникальный идентификатор обнаружения рисков. Наследуется от сущности
requestId	requestId	string	Идентификатор запроса входа, связанного с обнаружением рисков. Это свойство равно NULL, если обнаружение рисков не связано с входом
correlationId	correlationId	string	Идентификатор корреляции входа, связанного с обнаружением рисков. Это свойство равно NULL, если обнаружение рисков не связано с входом
riskEventType	riskEventType	string	Тип обнаруженного события риска
riskState	riskState	string	Состояние обнаруженного опасного пользователя или входа
riskLevel	riskLevel	string	Уровень обнаруженного риска
riskDetail	riskDetail	string	Сведения об обнаруженной опасности
source	source	string	Источник обнаружения рисков
detectionTimingType	detectionTimingType	string	Дата и время обнаружения риска
активность	activity	string	Указывает тип действия, с который связан обнаруженный риск
tokenIssuerType	tokenIssuerType	string	Указывает тип издателя токена для обнаруженного риска входа
ipAddress	ipAddress	string	Предоставляет IP-адрес клиента, из которого произошел риск.
@@odata.type	location.@@odata.type	string
activityDateTime	activityDateTime	string	Дата и время возникновения рискованного действия
detectedDateTime	detectedDateTime	string	Дата и время обнаружения риска
lastUpdatedDateTime	lastUpdatedDateTime	string	Дата и время последнего обновления обнаружения рисков
userId	userId	string	Уникальный идентификатор пользователя
ИмяПользователя	userDisplayName	string	Основное имя пользователя (UPN) пользователя
userPrincipalName	userPrincipalName	string	Учетное имя (UPN) пользователя.
дополнительная информация	additionalInfo	string	Дополнительные сведения, связанные с обнаружением рисков в формате JSON.

Get_risk_history

Имя	Путь	Тип	Описание
@@odata.type	@@odata.type	string
id	id	string	Наследуется от сущности
isDeleted	isDeleted	string	Наследуется от riskyUser
isProcessing	isProcessing	string	Наследуется от riskyUser
riskLastUpdatedDateTime	riskLastUpdatedDateTime	string	Наследуется от riskyUser
riskLevel	riskLevel	string	Наследуется от riskyUser
riskState	riskState	string	Наследуется от riskyUser
riskDetail	riskDetail	string	Наследуется от riskyUser
ИмяПользователя	userDisplayName	string	Наследуется от riskyUser
userPrincipalName	userPrincipalName	string	Имя субъекта-пользователя рискованного пользователя
userId	userId	string	Идентификатор пользователя
инициированоBy	initiatedBy	string	Идентификатор субъекта, который выполняет операцию
@@odata.type	activity.@@odata.type	string