Événements Microsoft Entra

  • Article

Cet article fournit les propriétés et le schéma des événements Microsoft Entra, publiés par l’API Microsoft Graph. Pour une introduction aux schémas d’événements, consultez le schéma CloudEvents.

Types d’événement disponibles

Ces événements sont déclenchés lorsqu’un utilisateur ou un groupe est créé, mis à jour ou supprimé dans Microsoft Entra ID ou en utilisant ces ressources à l’aide de l’API Microsoft Graph.

Nom de l’événement Description
Microsoft.Graph.UserUpdated Déclenché quand un utilisateur est créé ou mis à jour dans Microsoft Entra ID.
Microsoft.Graph.UserDeleted Déclenché quand un utilisateur est définitivement supprimé dans Microsoft Entra ID.
Microsoft.Graph.GroupUpdated Déclenché quand un groupe est créé ou mis à jour dans Microsoft Entra ID.
Microsoft.Graph.GroupDeleted Déclenché quand un groupe est définitivement supprimé dans Microsoft Entra ID.

Remarque

Par défaut, la suppression d’un utilisateur ou d’un groupe n’est qu’une opération de suppression réversible, ce qui signifie que l’utilisateur ou le groupe est marqué comme supprimé, mais que l’objet utilisateur ou groupe existe toujours. Microsoft Graph envoie un événement mis à jour quand des utilisateurs sont supprimés de manière réversible. Pour supprimer définitivement un utilisateur, accédez à la page Supprimer des utilisateurs dans le portail Azure, puis sélectionnez Supprimer définitivement. Les étapes de suppression définitive d’un groupe sont similaires.

Exemple d’événement

Lorsqu’un événement est déclenché, le service Event Grid envoie les données relatives à cet événement aux destinations d’abonnement. Cette section contient un exemple de ce à quoi ces données ressembleraient pour chaque événement Microsoft Entra.

Événement Microsoft.Graph.UserUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.UserUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Users/<user-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "updated",
    "clientState": "<guid>",
    "resource": "Users/<user-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.User",
      "@odata.id": "Users/<user-id>",
      "id": "<user-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Événement Microsoft.Graph.UserDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.UserDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Users/<user-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "deleted",
    "clientState": "<guid>",
    "resource": "Users/<user-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.User",
      "@odata.id": "Users/<user-id>",
      "id": "<user-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Événement Microsoft.Graph.GroupUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.GroupUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Groups/<group-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "updated",
    "clientState": "<guid>",
    "resource": "Groups/<group-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.Group",
      "@odata.id": "Groups/<group-id>",
      "id": "<group-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Événement Microsoft.Graph.GroupDeleted

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.GroupDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "Groups/<group-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "changeType": "deleted",
    "clientState": "<guid>",
    "resource": "Groups/<group-id>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.Group",
      "@odata.id": "Groups/<group-id>",
      "id": "<group-id>",
      "organizationId": "<tenant-id>",
      "eventTime": "2022-05-24T22:24:31.3062901Z",
      "sequenceNumber": <sequence-number>
    },
    "subscriptionExpirationDateTime": "2022-05-24T23:21:19.3554403+00:00",
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>
  }
}

Propriétés d’événement

Un événement contient les données générales suivantes :

Propriété Type Description
source string Source d’événement du locataire. Ce champ n’est pas modifiable. L’API Microsoft Graph fournit cette valeur.
subject string Chemin de l’objet de l’événement, défini par le serveur de publication.
type string Un des types d’événements pour cette source d’événement.
time string Heure à laquelle l’événement est généré selon l’heure UTC du fournisseur
id string Identificateur unique de l’événement.
data object Charge utile d’événement qui fournit les données relatives au changement d’état de la ressource.
specversion string Version de la spécification de schéma CloudEvents.

L’objet de données comporte les propriétés suivantes :

Propriété Type Description
changeType string Type de modification de l’état de la ressource.
resource string Identificateur de ressource pour lequel l’événement a été déclenché.
tenantId string ID d’organisation où l’utilisateur ou le groupe est conservé.
clientState string Secret fourni par l’utilisateur au moment de la création de l’abonnement à l’API Graph.
@odata.type string Type de modification de l’API Graph.
@odata.id string Identificateur de ressource de l’API Graph pour lequel l’événement a été déclenché.
id string Identificateur de ressource pour lequel l’événement a été déclenché.
organizationId string Identificateur du locataire Microsoft Entra.
eventTime string Heure à laquelle l’état de la ressource a changé.
sequenceNumber string Numéro séquentiel.
subscriptionExpirationDateTime string Heure au format RFC 3339 à laquelle l’abonnement à l’API Graph expire.
subscriptionId string Identificateur d’abonnement à l’API Graph.
tenantId string Identificateur du locataire Microsoft Entra.

Étapes suivantes