Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente Microsoft Entra utilisateurs à risque. Microsoft Entra ID Protection évalue continuellement les risques de l’utilisateur en fonction de différents signaux et du Machine Learning. Cette API fournit un accès par programmation à tous les utilisateurs à risque dans votre locataire Microsoft Entra.
Pour plus d’informations sur les événements à risque, consultez protection Microsoft Entra ID.
Remarque
- L’utilisation de l’API riskyUsers nécessite une licence Microsoft Entra ID P2.
- La disponibilité des données utilisateur à risque est régie par les stratégies de conservation des données Microsoft Entra.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| List | collection riskyUser | Obtenez la liste des objets riskyUser et de leurs propriétés. |
| Obtenir | riskyUser | Lisez les propriétés et les relations d’un objet riskyUser . |
| Confirmer la compromission | Aucun | Vérifiez qu’un ou plusieurs objets riskyUser sont compromis. |
| Confirmer la sécurité | Aucun | Confirmez qu’un ou plusieurs objets riskyUser sont sécurisés. |
| Dismiss | Aucun | Ignorez le risque d’un ou de plusieurs objets riskyUser . |
| Historique des listes | collection riskyUserHistoryItem | Obtenez les riskyUserHistoryItems à partir de la propriété de navigation de l’historique. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| id | string | ID unique de l’utilisateur à risque. |
| isDeleted | Booléen | Indique si l’utilisateur est supprimé. Les valeurs possibles sont : true, false. |
| isProcessing | Booléen | Indique si l’état à risque d’un utilisateur est traité par le back-end. |
| riskLastUpdatedDateTime | DateTimeOffset | Date et heure de la dernière mise à jour de l’utilisateur à risque. Le type DateTimeOffset représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| riskLevel | riskLevel | Niveau de l’utilisateur à risque détecté. Les valeurs possibles sont low, medium, high, hidden, none, unknownFutureValue. |
| riskState | riskState | État du risque de l’utilisateur. Les valeurs possibles sont none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue. |
| riskDetail | riskDetail | Détails du risque détecté. Note: Les détails de cette propriété sont disponibles uniquement pour les clients Microsoft Entra ID P2. Tous les autres clients sont retournés hidden. |
| userDisplayName | string | Nom d’affichage de l’utilisateur à risque. |
| userPrincipalName | chaîne | Nom d’utilisateur principal à risque. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "Boolean",
"isDeleted": "Boolean",
"riskDetail": "string",
"riskLevel": "string",
"riskState": "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}