tipo de recurso riskyUser

  • Artículo

Espacio de nombres: microsoft.graph

Representa a los usuarios de Microsoft Entra que están en riesgo. Microsoft Entra ID evalúa continuamente el riesgo del usuario en función de varias señales y aprendizaje automático. Esta API proporciona acceso mediante programación a todos los usuarios en riesgo en su id. de Microsoft Entra.

Para obtener más información sobre los eventos de riesgo, consulte Microsoft Entra ID Protection.

Nota:

  1. El uso de la API riskyUsers requiere una licencia de Microsoft Entra ID P2.
  2. La disponibilidad de datos de usuario de riesgo se rige por las directivas de retención de datos de Microsoft Entra.

Métodos

Método Tipo devuelto Descripción
List colección riskyUser Obtenga una lista de los objetos riskyUser y sus propiedades.
Get riskyUser Lea las propiedades y relaciones de un objeto riskyUser .
Confirmar lo que está en peligro Ninguno Confirme que uno o más objetos RiskyUser están en peligro.
Dismiss Ninguno Descartar el riesgo de uno o más objetos RiskyUser .
Historial de listas colección riskyUserHistoryItem Obtenga riskyUserHistoryItems de la propiedad de navegación history.

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador único del usuario en riesgo.
isDeleted Booleano Indica si se elimina el usuario. Los valores posibles son true y false.
isProcessing Booleano Indica si el back-end está procesando el estado de riesgo de un usuario.
riskLastUpdatedDateTime DateTimeOffset Fecha y hora en que se actualizó por última vez el usuario de riesgo. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
riskLevel riskLevel Nivel del usuario de riesgo detectado. Los valores posibles son: low, medium, high, hidden, none, unknownFutureValue.
riskState riskState Estado del riesgo del usuario. Valores posibles: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.
riskDetail riskDetail Los valores posibles son none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafeuserPassedMFADrivenByRiskBasedPolicy, , adminDismissedAllRiskForUser, , adminConfirmedSigninCompromised, hidden, adminConfirmedUserCompromised, unknownFutureValue, adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal, , m365DAdminDismissedDetection, userChangedPasswordOnPremises, , adminDismissedRiskForSignIn. adminConfirmedAccountSafe Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener el siguiente valor o valores en esta enumeración evolvable: adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal, m365DAdminDismissedDetection, userChangedPasswordOnPremises, adminDismissedRiskForSignIn, adminConfirmedAccountSafe.
userDisplayName Cadena Nombre para mostrar de usuario de riesgo.
userPrincipalName Cadena Nombre principal de usuario de riesgo.

Relaciones

Relación Tipo Descripción
historia colección riskyUserHistoryItem La actividad relacionada con el cambio de nivel de riesgo del usuario

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.riskyUser",
  "id": "String (identifier)",
  "isDeleted": "Boolean",
  "isProcessing": "Boolean",
  "riskLastUpdatedDateTime": "String (timestamp)",
  "riskLevel": "String",
  "riskState": "String",
  "riskDetail": "String",
  "userDisplayName": "String",
  "userPrincipalName": "String"
}