Compartir a través de

tipo de recurso riskyUser

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa Microsoft Entra usuarios que están en riesgo. Microsoft Entra ID Protection 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 del inquilino de Microsoft Entra.

Para obtener más información sobre los eventos de riesgo, consulte protección contra 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 de valor 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.
Confirmación de la seguridad Ninguno Confirme uno o más objetos riskyUser como seguros.
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 string Identificador único del usuario en riesgo.
isDeleted Booleano Indica si se elimina el usuario. Los valores posibles son: true, 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. Los valores posibles son: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised y unknownFutureValue.
riskDetail riskDetail Detalles del riesgo detectado.
Nota: Los detalles de esta propiedad solo están disponibles para Microsoft Entra ID clientes de P2. Todos los demás clientes se devuelven hidden.
userDisplayName string Nombre para mostrar de usuario de riesgo.
userPrincipalName string Nombre principal de usuario de riesgo.

Relaciones

Ninguna.

Representación JSON

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

{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "Boolean",
"isDeleted": "Boolean",
"riskDetail":  "string",
"riskLevel":  "string",
"riskState":  "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}
  • Last updated on