Delen via

Microsoft Entra-gebeurtenissen

  • Artikel

Dit artikel bevat de eigenschappen en het schema voor Microsoft Entra-gebeurtenissen, die worden gepubliceerd door Microsoft Graph API. Zie Het CloudEvents-schema voor een inleiding tot gebeurtenisschema's.

Beschikbare gebeurtenistypen

Deze gebeurtenissen worden geactiveerd wanneer een gebruiker of groep wordt gemaakt, bijgewerkt of verwijderd in Microsoft Entra-id of door deze resources te gebruiken met behulp van Microsoft Graph API.

Notitie

UserUpdated Momenteel wordt er een GroupUpdated gebeurtenis gegenereerd wanneer een gebruiker of groep wordt gemaakt. Het is een bekend probleem en wordt opgelost in de toekomstige release.

Gebeurtenisnaam Beschrijving
Microsoft.Graph.UserUpdated Geactiveerd wanneer een gebruiker in Microsoft Entra-id wordt gemaakt of bijgewerkt.
Microsoft.Graph.UserDeleted Geactiveerd wanneer een gebruiker in Microsoft Entra ID definitief wordt verwijderd.
Microsoft.Graph.GroupUpdated Geactiveerd wanneer een groep in Microsoft Entra-id wordt gemaakt of bijgewerkt.
Microsoft.Graph.GroupDeleted Geactiveerd wanneer een groep in Microsoft Entra-id definitief wordt verwijderd.

Notitie

Het verwijderen van een gebruiker of groep is standaard alleen een bewerking voor voorlopig verwijderen, wat betekent dat de gebruiker of groep is gemarkeerd als verwijderd, maar het gebruikers- of groepsobject nog steeds bestaat. Microsoft Graph verzendt een bijgewerkte gebeurtenis wanneer gebruikers voorlopig worden verwijderd. Als u een gebruiker definitief wilt verwijderen, gaat u naar de pagina Gebruikers verwijderen in Azure Portal en selecteert u Definitief verwijderen. Stappen voor het definitief verwijderen van een groep zijn vergelijkbaar.

Voorbeeld van een gebeurtenis

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis om bestemmingen te abonneren. Deze sectie bevat een voorbeeld van hoe die gegevens eruit zouden zien voor elke Microsoft Entra-gebeurtenis.

Microsoft.Graph.UserUpdated-gebeurtenis

{
  "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>
  }
}

Microsoft.Graph.UserDeleted-gebeurtenis

{
  "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>
  }
}

Microsoft.Graph.GroupUpdated-gebeurtenis

{
  "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>
  }
}

Microsoft.Graph.GroupDeleted-gebeurtenis

{
  "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>
  }
}

Eigenschappen van gebeurtenis

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
source tekenreeks De bron van de tenant-gebeurtenis. Dit veld kan niet worden geschreven. Microsoft Graph API biedt deze waarde.
subject tekenreeks Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
type tekenreeks Een van de gebeurtenistypen voor deze gebeurtenisbron.
time tekenreeks Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider
id tekenreeks Unieke id voor de gebeurtenis.
data object Nettolading van gebeurtenissen die de gegevens over de wijziging van de resourcestatus levert.
specversion tekenreeks CloudEvents schemaspecificatieversie.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
changeType tekenreeks Het type resourcestatuswijziging.
resource tekenreeks De resource-id waarvoor de gebeurtenis is gegenereerd.
tenantId tekenreeks De organisatie-id waar de gebruiker of groep wordt bewaard.
clientState tekenreeks Een geheim dat door de gebruiker wordt verstrekt op het moment dat het Graph API-abonnement is gemaakt.
@odata.type tekenreeks Het type Graph API-wijziging.
@odata.id tekenreeks De Graph API-resource-id waarvoor de gebeurtenis is gegenereerd.
id tekenreeks De resource-id waarvoor de gebeurtenis is gegenereerd.
organizationId tekenreeks De Tenant-id van Microsoft Entra.
eventTime tekenreeks Het tijdstip waarop de resourcestatus is gewijzigd.
sequenceNumber tekenreeks Een volgnummer.
subscriptionExpirationDateTime tekenreeks De tijd in RFC 3339-indeling waarop het Graph API-abonnement verloopt.
subscriptionId tekenreeks De Graph API-abonnements-id.
tenantId tekenreeks De Tenant-id van Microsoft Entra.

Volgende stappen