Partager via


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.