tipo de recurso riskyUser

Espacio de nombres: microsoft.graph

Representa Microsoft Entra usuarios 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 de la Microsoft Entra ID.

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

Nota:

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

Métodos

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

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"
}