Compartir a través de

Suscripción a eventos publicados por Microsoft Entra ID mediante Azure Portal

En este artículo se describen los pasos para suscribirse a eventos publicados por Microsoft Entra ID mediante Azure Portal.

Creación de un tema de asociado

  1. Navegue hasta Azure Portal.

  2. En el cuadro de búsqueda, escriba Event Grid y seleccione Event Grid en los resultados.

    Captura de pantalla que muestra el cuadro de búsqueda con Event Grid.

  3. En el menú de la izquierda, expanda Eventos de asociado, seleccione Asociados disponibles.

  4. En el icono Microsoft Entra ID, seleccione Crear.

    Captura de pantalla que muestra la página Asociados disponibles con Microsoft Entra ID seleccionado.

  5. En la pestaña suscripción de Microsoft Graph API del asistente, siga estos pasos:

    1. En suscripción, seleccione la suscripción de Azure en la que desea crear el tema de asociado.

    2. En Grupo de recursos, seleccione el grupo de recursos para el recurso del tema del asociado.

    3. Para Ubicación, seleccione la región en la que desea crear el tema de asociado.

    4. En Nombre del tema asociado, escriba un nombre para el tema del asociado.

    5. En Recurso, especifique el recurso para el que desea recibir las notificaciones. Por ejemplo: users.

      Captura de pantalla que muestra la página de suscripción de Microsoft Graph API con hasta el recurso especificado.

    6. En Tipo de cambio, seleccione los tipos de eventos para los que desea recibir una notificación.

      Captura de pantalla que muestra la página de suscripción de Microsoft Graph API con los tipos actualizados y eliminados seleccionados.

    7. En Fecha y hora de expiración, seleccione fecha y hora en que expire el tema del asociado.

      Captura de pantalla que muestra la página de suscripción de Microsoft Graph API con la hora de expiración especificada.

    8. Seleccione Habilitar eventos de ciclo de vida opciones si desea que se admita el evento Microsoft.Graph.ReauthorizationRequired. Para más información sobre los eventos de ciclo de vida, consulte Notificaciones de ciclo de vida para suscripciones.

    9. Seleccione Siguiente: Configuración de asociados en la parte inferior de la página.

  6. En la página Configuración de asociado, siga estos pasos:

    1. Seleccione + Autorización de asociados.

      Captura de pantalla que muestra la selección de + Autorización de asociado en la página Configuración del asociado.

    2. En la página Agregar autorización de asociado para crear recursos, seleccione Microsoft Graph API, especifique Tiempo de expiración de autorización y seleccione Agregar.

      Captura de pantalla que muestra la selección de Microsoft Graph API.

    3. Ahora, en la página Configuración de partners, seleccione Siguiente: Revisar y crear en la parte inferior de la página.

      Captura de pantalla que muestra la selección del botón Siguiente: Revisar y crear.

  7. En la página Revisar y crear, revise toda la configuración y seleccione Crear.

    Captura de pantalla que muestra la página Revisar y crear.

  8. Después de crear la suscripción de Graph API y activar el tema del asociado, verá un vínculo para ir al tema de asociado en el portal.

    Captura de pantalla que muestra la página Crear con un vínculo para ir al tema del asociado.

Suscripción a eventos de asociados

En este momento, los eventos de Microsoft Graph API deben llegar al tema del asociado activado siempre que haya cambios en los recursos especificados al crear la suscripción de Microsoft Graph API. Para procesar los eventos, debe crear una suscripción de eventos que reenvíe los eventos a un controlador de eventos, como un webhook o cualquiera de los servicios de Azure admitidos.

Importante

En esta sección, encontrará una manera de recibir eventos mediante una aplicación de ejemplo, el Visor de Event Grid. Esta aplicación le ayuda a probar la canalización de datos para recibir eventos antes de crear su propia aplicación para controlar los eventos según sus requisitos empresariales. Cuando esté listo para compilar la aplicación, consulte los ejemplos de aplicación completos.

Implementación de la aplicación visor de eventos

Para probar el tema del asociado, implemente el Visor de eventos, que es una aplicación web precompilada. La aplicación Visor de eventos muestra todos los eventos entregados. La solución implementada incluye un plan de App Service, una aplicación web de App Service y el código fuente desde GitHub.

  1. Seleccione Implementar en Azure para implementar la solución en la suscripción de Azure. En Azure Portal, proporcione valores para los parámetros.

    Botón para implementar la plantilla de Resource Manager en Azure.

  2. En la página Implementación personalizada, siga estos pasos:

    1. Seleccione un Grupo de recursos donde se implemente la aplicación.

    2. En Nombre del sitio, escriba el nombre de la aplicación web.

    3. En Nombre del plan de hospedaje, escriba el nombre del plan de App Service que se va a usar para hospedar la aplicación web.

    4. Seleccione Revisar + crear.

      Captura de pantalla que muestra la página Implementación personalizada.

  3. En la página Revisar y crear, seleccione Crear.

  4. La implementación tarda unos minutos en completarse. Seleccione Alertas (el icono de la campana) en el portal y, después, seleccione Ir al grupo de recursos.

    Captura de pantalla que muestra el mensaje de implementación correcta con un vínculo para ir al grupo de recursos.

  5. En la página Grupo de recursos, en la lista de recursos, seleccione la aplicación web que ha creado. También verá el plan de App Service y cualquier otro recurso que tenga en el grupo de recursos.

    Captura de pantalla que muestra la página Grupo de recursos con los recursos implementados.

  6. En la página App Service de la aplicación web, seleccione la dirección URL para ir al sitio web. La dirección URL debe tener este formato: https://<your-site-name>.azurewebsites.net.

    Captura de pantalla que muestra la página de App Service con el vínculo al sitio resaltado.

  7. Confirme que ve el sitio pero aún no hay ningún evento publicado.

    Captura de pantalla que muestra la aplicación de ejemplo Visor de Event Grid.

Creación de una suscripción a evento

Suscríbase a un tema de asociado de Event Grid para indicar a Event Grid qué eventos desea realizar un seguimiento y dónde enviar los eventos.

  1. Ahora, en la página Tema de partners de Event Grid, seleccione + Suscripción de eventos en la barra de herramientas.

  2. En la página Crear suscripción de eventos, siga estos pasos:

    1. Escriba un nombre para la suscripción a eventos.

    2. Seleccione Webhook como Tipo de punto de conexión.

    3. Elija Seleccionar un punto de conexión.

      Proporcionar valores de suscripción a eventos

    4. Para el punto de conexión de webhook, proporcione la dirección URL de la aplicación web y agregue api/updates a la dirección URL de la página principal. Seleccione Confirm Selection (Confirmar selección).

      Proporcionar la dirección URL del punto de conexión

    5. De nuevo en la página Crear suscripción de eventos, seleccione Crear.

  3. Vuelva a ver la aplicación web y debería ver un nuevo evento de validación de suscripción. Seleccione el icono del ojo para expandir los datos del evento. Event Grid envía el evento de validación para que el punto de conexión pueda verificar que desea recibir datos de eventos. La aplicación web incluye código para validar la suscripción.

    Captura de pantalla de la aplicación Visor de Event Grid con el evento Suscripción validada.

Prueba del flujo de eventos

Ya está listo para probar la suscripción de Microsoft Entra ID. Según el tipo de cambio proporcionado al crear la suscripción de Microsoft Entra ID, actualice o elimine el recurso al que está realizando el seguimiento. Debería ver un evento mostrado en la aplicación Visor de eventos para cada cambio de recurso que realice.

Pasos siguientes

  • Creación de su propia aplicación de controlador de eventos de asociado
    • Use las aplicaciones de ejemplo como una manera de acelerar el esfuerzo de desarrollo. Después de tener la aplicación, puede actualizar el punto de conexión de la suscripción de eventos con el punto de conexión de la aplicación.
    • Para fines de producción, es posible que quiera automatizar la creación de la suscripción de Microsoft Graph API y, por tanto, el tema del asociado. Para ello, las aplicaciones de ejemplo también son un buen recurso. Es posible que quiera consultar los fragmentos de código de la sección Creación de una suscripción de Microsoft Graph API para obtener una referencia rápida.
    • Las aplicaciones de ejemplo también muestran cómo renovar las suscripciones de Microsoft Graph API para garantizar un flujo continuo de eventos. Debe comprender los conceptos subyacentes a la renovación de suscripciones y las API llamadas en la sección Renovación de una suscripción de Microsoft Graph API