Тип ресурса signIn

  • Статья

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

Сведения о действиях входа пользователей и приложений для клиента (каталога). Для скачивания журналов входа с помощью API Graph Майкрософт требуется лицензия на Microsoft Entra ID P1 или P2.

Доступность журналов входа регулируется политиками хранения данных Microsoft Entra.

Методы

Метод Возвращаемый тип Описание
Перечисление signIn signIn Чтение свойств и связей объектов signIn .
Получение объекта signIn signIn Чтение свойств и связей объекта signIn .

Свойства

Свойство Тип Описание
appDisplayName String Имя приложения, отображаемое в Центр администрирования Microsoft Entra.

Поддерживает $filter (eq, startsWith).
appId String Уникальный идентификатор GUID, представляющий идентификатор приложения в Microsoft Entra ID.

Поддерживает $filter (eq).
appliedConditionalAccessPolicies Коллекция appliedConditionalAccessPolicy Список политик условного доступа, которые активирует соответствующее действие входа. Приложениям требуется больше привилегий, связанных с условным доступом, для чтения сведений об этом свойстве. Дополнительные сведения см. в разделе Просмотр политик примененного условного доступа (ЦС) в входах.
clientAppUsed String Определяет клиент, используемый для действия входа. Современные клиенты проверки подлинности включают Browser, modern clients. Устаревшие клиенты проверки подлинности включают Exchange ActiveSync, IMAP, MAPI, SMTP, POPи other clients.

Поддерживает $filter (eq).
conditionalAccessStatus conditionalAccessStatus Сообщает о состоянии активированной политики условного доступа. Возможные значения: success, failure, notApplied и unknownFutureValue.

Поддерживает $filter (eq).
correlationId String Идентификатор запроса, отправленного клиентом при инициации входа. Используется для устранения неполадок при входе.

Поддерживает $filter (eq).
createdDateTime DateTimeOffset Дата и время (UTC) для входа. Пример: полночь 1 января 2014 г. указывается как 2014-01-01T00:00:00Z.

Поддерживает $orderby, $filter (eq, leи ge).
deviceDetail deviceDetail Сведения об устройстве, где произошел вход; включает идентификатор устройства, операционную систему и браузер.

Поддерживает $filter (eq, startsWith) в свойствах браузера и operatingSytem .
id String Уникальный идентификатор, представляющий действие входа.

Поддерживает $filter (eq).
ipAddress String IP-адрес клиента, используемого для входа.

Поддерживает $filter (eq, startsWith).
isInteractive Boolean Указывает, является ли вход интерактивным.
location signInLocation Предоставляет код города, штата и страны, в которых был создан вход.

Поддерживает $filter (eq, startsWith) для свойств city, state и countryOrRegion .
resourceDisplayName String Имя ресурса, в который вошел пользователь.

Поддерживает $filter (eq).
resourceId String Идентификатор ресурса, в который вошел пользователь.

Поддерживает $filter (eq).
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 Это значение none означает, что Microsoft Entra обнаружение риска пока не помечает пользователя или входа как рискованное событие.

Поддерживает $filter (eq).
Примечание: Сведения об этом свойстве доступны только для клиентов Microsoft Entra ID P2. Все остальные клиенты возвращаются hidden.
riskEventTypes_v2 Коллекция строк Список типов событий риска, связанных с входом. Возможные значения: unlikelyTravel, anonymizedIPAddress, maliciousIPAddress, unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddress, leakedCredentials, investigationsThreatIntelligence, genericили unknownFutureValue.

Поддерживает $filter (eq, startsWith).
riskLevelAggregated riskLevel Агрегированный уровень риска. Допустимые значения: none, low, medium, high, hidden и unknownFutureValue. Значение hidden означает, что пользователь или вход не был включен для Защита Microsoft Entra ID.

Поддерживает $filter (eq).
Примечание: Сведения об этом свойстве доступны только для клиентов Microsoft Entra ID P2. Все остальные клиенты возвращаются hidden.
riskLevelDuringSignIn riskLevel Уровень риска во время входа. Допустимые значения: none, low, medium, high, hidden и unknownFutureValue. Значение hidden означает, что пользователь или вход не был включен для Защита Microsoft Entra ID.

Поддерживает $filter (eq).
Примечание: Сведения об этом свойстве доступны только для клиентов Microsoft Entra ID P2. Все остальные клиенты возвращаются hidden.
riskState riskState Сообщает о состоянии пользователя, подверженного риску, входа или события риска. Возможные значения: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.

Поддерживает $filter (eq).
status signInStatus Состояние входа. Включает код ошибки и описание ошибки (при сбое входа).

Поддерживает $filter (eq) для свойства errorCode .
userDisplayName String Отображаемое имя пользователя, который инициировал вход.

Поддерживает $filter (eq, startsWith).
userId String Идентификатор пользователя, инициировавшем вход.

Поддерживает $filter (eq).
userPrincipalName String Имя участника-пользователя, инициировавшем вход.

Поддерживает $filter (eq, startsWith).

Связи

Отсутствуют.

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

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

{
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "appDisplayName": "String",
  "appId": "String",
  "ipAddress": "String",
  "clientAppUsed": "String",
  "correlationId": "String",
  "conditionalAccessStatus": "string",
  "appliedConditionalAccessPolicy": [{"@odata.type": "microsoft.graph.appliedConditionalAccessPolicy"}],
  "isInteractive": true,
  "deviceDetail": {"@odata.type": "microsoft.graph.deviceDetail"},
  "location": {"@odata.type": "microsoft.graph.signInLocation"},
  "riskDetail": "string",
  "riskLevelAggregated": "string",
  "riskLevelDuringSignIn": "string",
  "riskState": "string",
  "riskEventTypes": ["string"],
  "riskEventTypes_v2": ["String"],
  "resourceDisplayName": "string",
  "resourceId": "string",
  "status": {"@odata.type": "microsoft.graph.signInStatus"},
  "userDisplayName": "string",
  "userId": "string",
  "userPrincipalName": "string"
}