identityRiskEvent resource type

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

A risk event detected by Azure Active Directory Identity Protection. Specific risk event types include: * sign-ins from anonymous IP addresses * sign-ins from malware-infected devices * impossible travel to atypical locations * users with leaked credentials * sign-ins from suspicious IP addresses * sign-ins from unfamiliar locations Complete information about risk events can be found in the Azure AD Identity Protection documentation.

Methods

Method Return Type Description
Get identityRiskEvent identityRiskEvent Read properties and relationships of identityRiskEvent object.

Properties

Property Type Description
closedDateTime dateTimeOffset The date and time that the risk event was closed
createdDateTime dateTimeOffset The date and time that the risk event was created. This is always greater than or equal to the datetime of the risk event itself. This is the correct property to use as a filter when querying risk events.
id string Read-only
riskEventDateTime dateTimeOffset The date and time when the risk event occurred
riskEventStatus string Possible values are: active, remediated, dismissedAsFixed, dismissedAsFalsePositive, dismissedAsIgnore, loginBlocked, closedMfaAuto, closedMultipleReasons.
riskLevel string Possible values are: low, medium, high.
riskEventType string The type of risk
userDisplayName string The name of the user at risk
userId string The id of the user at risk
userPrincipalName string The user principal name of the user at risk

Relationships

Relationship Type Description
impactedUser user Read-only. Nullable.

JSON representation

Here is a JSON representation of the resource.

{
  "closedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "id": "string (identifier)",
  "riskEventDateTime": "String (timestamp)",
  "riskEventStatus": "string",
  "riskLevel": "string",
  "riskType": "string",
  "userDisplayName": "string",
  "userId": "string",
  "userPrincipalName": "string"
}