Compartir a través de

Eventos de Microsoft Entra

  • Artículo

En este artículo se proporcionan las propiedades y el esquema de los eventos de Microsoft Entra, que son publicados por Microsoft Graph API. Para obtener una introducción a los esquemas de eventos, consulte Esquema de CloudEvents.

Tipos de eventos disponibles

Estos eventos se desencadenan cuando se crea, se actualiza o se elimina un usuario o grupo en Microsoft Entra ID, o cuando se opera sobre esos recursos mediante Microsoft Graph API.

Nota:

Actualmente, el evento UserUpdated o GroupUpdated se genera cuando se crea un usuario o un grupo. Es un problema conocido y se corregirá en la versión futura.

Nombre del evento Descripción
Microsoft.Graph.UserUpdated Se desencadena cuando se crea o actualiza un usuario en Microsoft Entra ID.
Microsoft.Graph.UserDeleted Se desencadena cuando se elimina permanentemente un usuario de Microsoft Entra ID.
Microsoft.Graph.GroupUpdated Se desencadena cuando se crea o actualiza un grupo en Microsoft Entra ID.
Microsoft.Graph.GroupDeleted Se desencadena cuando se elimina permanentemente un grupo de Microsoft Entra ID.

Nota:

De forma predeterminada, eliminar un usuario o un grupo es solo una operación de eliminación temporal, lo que significa que el usuario o grupo está marcado como eliminado, pero el objeto de usuario o grupo sigue existiendo. Microsoft Graph envía un evento actualizado cuando los usuarios se eliminan temporalmente. Para eliminar permanentemente un usuario, vaya a la página Eliminar usuarios en Azure Portal y seleccione Eliminar permanentemente. Los pasos para eliminar permanentemente un grupo son similares.

Evento de ejemplo

Cuando se desencadena un evento, el servicio Event Grid envía datos sobre ese evento a los destinos de suscripción. Esta sección contiene un ejemplo del aspecto que deben tener los datos para cada evento de Microsoft Entra.

Evento 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>
  }
}

Evento 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>
  }
}

Evento 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>
  }
}

Evento 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>
  }
}

Propiedades de evento

Un evento tiene los siguientes datos de nivel superior:

Propiedad Tipo Description
source string El origen de eventos del inquilino. En este campo no se puede escribir. Microsoft Graph API proporciona este valor.
subject string Ruta al asunto del evento definida por el anunciante.
type string Uno de los tipos de evento registrados para este origen de eventos.
time string La hora de generación del evento en función de la hora UTC del proveedor
id string Identificador único para el evento
data object Carga de eventos que proporciona los datos sobre el cambio de estado del recurso.
specversion string Versión de especificación del esquema CloudEvents.

El objeto data tiene las siguientes propiedades:

Propiedad Tipo Description
changeType string El tipo de cambio de estado del recurso.
resource string El identificador de recurso para el que se ha generado el evento.
tenantId string El Id. de la organización donde se mantiene el usuario o el grupo.
clientState string Un secreto proporcionado por el usuario en el momento de la creación de la suscripción de Graph API.
@odata.type string El tipo de cambio de Graph API.
@odata.id string El identificador de recursos de Graph API para el que se ha generado el evento.
id string El identificador de recurso para el que se ha generado el evento.
organizationId cadena Identificador de inquilino de Microsoft Entra.
eventTime cadena Hora a la que cambió el estado del recurso.
sequenceNumber cadena Número de secuencia.
subscriptionExpirationDateTime string La hora en formato RFC 3339 en la que expira la suscripción de Graph API.
subscriptionId string El identificador de la suscripción de Graph API.
tenantId cadena Identificador de inquilino de Microsoft Entra.

Pasos siguientes