Présentation de l’API des rapports d’activité
Espace de noms : microsoft.graph
Microsoft Entra ID effectue le suivi de l’activité des utilisateurs et crée des rapports qui vous aident à comprendre comment vos utilisateurs accèdent aux services Microsoft Entra et les utilisent. Utilisez le API Graph Microsoft pour Microsoft Entra ID afin d’analyser les données de ces rapports et de créer des solutions personnalisées adaptées aux besoins spécifiques de votre organization.
La disponibilité de ces rapports d’activité est régie par les stratégies de conservation des données Microsoft Entra. Pour plus d’informations, voir des stratégies de rétention des données.
Que sont les journaux d’activité Microsoft Entra ?
Microsoft Entra ID fournit les types de rapports d’activité suivants :
- Audits d’annuaires
- Connexions
Audits d’annuaires
Le rapport d’audit d’annuaire vous permet d’accéder à l’historique de toutes les tâches effectuées dans votre client. Le rapport d’audit d’annuaire vous fournit des enregistrements des activités du système aux fins de conformité. Entre autres, les données fournies vous permettent d'aborder des scénarios courants tels que :
- Qui a accordé l’accès au groupe d’administration à un utilisateur de niveau répertoire?
- Quels utilisateurs se connectent à une application récemment acquise ?
- Combien de mots de passe ont été réinitialisés dans le répertoire ?
Connexions
Le rapport des connexions vous aide à déterminer qui a exécuté les tâches signalées dans les audits d’annuaires. Le rapport des connexions vous permet de répondre à des questions telles que :
- Quel est le motif de connexion d’un utilisateur ?
- Combien d’utilisateurs se sont connectés au cours de la semaine dernière ?
- Quel est le statut de ces connexions ?
Que puis-je faire avec les API de journal d’audit dans Microsoft Graph ?
Voici les demandes populaires permettant de manipuler les données du journal d’audit :
| Opération | URL |
|---|---|
| OBTENIR les activités des utilisateurs | GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits |
| OBTENIR les connexions des utilisateurs | GET https://graph.microsoft.com/v1.0/auditLogs/signIns |
Critères de licence
Les rapports d’activité sont disponibles pour les fonctionnalités pour lesquelles vous avez une licence. Si vous possédez une licence pour une fonctionnalité spécifique, vous avez également accès à ses rapports. Pour plus d’informations sur les licences requises pour les différents rapports d’activité, consultez Microsoft Entra journaux d’audit : Licences et rôles requis.
Contenu connexe
- Commencez à utiliser les ressources suivantes représentant les différents rapports d’activité :