Introducción a los eventos de asociados para asociados: Azure Event Grid

Artigo
04/12/2023

Los eventos de asociados de Event Grid permiten que los clientes se suscriban a eventos que se originan en un sistema registrado mediante el mismo mecanismo que usarían para cualquier otro origen de eventos en Azure, como un servicio de Azure. Esos sistemas registrados que se integran con Event Grid se conocen como "asociados". Esta característica también permite que los clientes envíen eventos a sistemas asociados que admiten la recepción y enrutamiento de eventos a las soluciones o puntos de conexión del cliente en su plataforma. Normalmente, los asociados son proveedores de software como servicio (SaaS) o ERP, pero pueden ser plataformas corporativas que quieran poner sus eventos a disposición de los equipos internos. Se integran específicamente con Event Grid para realizar casos de uso de clientes de un extremo a otro que terminan en Azure (los clientes se suscriben a eventos enviados por el asociado) o terminan en un sistema de asociados (los clientes se suscriben a eventos de Microsoft enviados por Azure Event Grid). Los clientes se basan en Azure Event Grid para enviar eventos publicados por un asociado a destinos admitidos, como webhooks, Azure Functions, Azure Event Hubs o Azure Service Bus, entre otros. Los clientes también dependen de Azure Event Grid para enrutar eventos que se originan en servicios Microsoft, como Outlook, Teams o Microsoft Entra ID, para que las soluciones del cliente pueden reaccionar ante ellos. Con los eventos de asociados, los clientes pueden crear soluciones controladas por eventos entre plataformas y límites de red para recibir o enviar eventos de forma confiable, segura y a escala.

Nota

Este es un artículo conceptual que es necesario leer antes de decidir incorporarse como asociado para Azure Event Grid. Puede encontrar instrucciones paso a paso sobre cómo incorporarse como asociado de Event Grid mediante Azure Portal en Incorporación como asociado de Event Grid (Azure Portal).

Eventos de asociados: cómo funcionan

Como asociado, creará recursos de Event Grid que le permitirán publicar eventos en Azure Event Grid para que los clientes de Azure puedan suscribirse a ellos. Para la mayoría de los asociados, por ejemplo, los proveedores de SaaS, es la única funcionalidad de integración que usarán.

También puede crear recursos de Event Grid para recibir eventos de Azure Event Grid. Este caso de uso es para aquellas organizaciones que poseen o administran una plataforma que permite a sus clientes recibir eventos mediante la exposición de puntos de conexión. Algunas de esas organizaciones son sistemas ERP que también tienen funcionalidades de enrutamiento de eventos dentro de su plataforma, que envía los eventos entrantes de Azure a una aplicación cliente hospedada en su plataforma.

Para publicar o recibir eventos, cree el mismo tipo de recursos de Event Grid siguiendo estos pasos generales.

Póngase en contacto con el equipo de Event Grid en askgrid@microsoft.com para comunicar su interés en convertirse en asociado. Una vez que se comunique con nosotros, le guiaremos a través del proceso de incorporación y ayudaremos a su servicio a obtener una tarjeta de entrada en nuestra galería de Azure Event Grid para que su servicio se pueda encontrar en Azure Portal.
Creación de un registro de asociado. Se trata de un recurso global y normalmente es necesario crearlo una vez.
Creación de un espacio de nombres de asociado. Este recurso expone un punto de conexión al que puede publicar eventos en Azure. Al crear el espacio de nombres del asociado, proporcione el registro de asociado que creó.
El cliente le autoriza a crear un tema de asociado en la suscripción de Azure del cliente.
El cliente accede a la página web o ejecuta un comando, define la experiencia del usuario, para solicitar el flujo de los eventos a Azure o la capacidad de recibir eventos de Microsoft en el sistema. En respuesta a esa solicitud, configura el sistema para hacerlo con la entrada del cliente. Por ejemplo, el cliente puede tener la opción de seleccionar determinados eventos del sistema que se deben reenviar a Azure.
Cree un tema de asociado en la suscripción y el grupo de recursos de Azure del cliente mediante canales. Los canales son recursos contenidos por espacios de nombres de asociados.
El cliente activa el tema del asociado que usted creó en su suscripción y grupo de recursos de Azure.
Empiece a publicar eventos en el espacio de nombres del asociado.

Nota

Debe registrar el proveedor de recursos de Azure Event Grid en cada suscripción de Azure en la que quiera crear recursos de Event Grid. De lo contrario, se producirá un error en las operaciones para crear recursos.

¿Por qué debería usar Eventos de asociado?

Puede que quiera usar la característica Eventos de asociado si tiene uno o varios de los requisitos siguientes.

Para asociados como publicadores de eventos

Quiere un mecanismo que permita que sus eventos estén disponibles para los clientes en Azure. Los usuarios pueden filtrar y enrutar esos eventos mediante el uso de temas de asociado y suscripciones de eventos que poseen y administran. Puede usar otros enfoques de integración, como temas y dominios. Sin embargo, esos enfoques no permitirían una separación limpia de la propiedad, la administración y la facturación de los recursos entre usted y el cliente. La característica Eventos de asociado también proporciona una experiencia de usuario más intuitiva que facilita la detección del servicio.
Necesita un modelo multiinquilino sencillo donde publique eventos en un único punto de conexión regional, el punto de conexión del espacio de nombres, para enrutar los eventos a distintos clientes.
Quiere tener visibilidad de las métricas relacionadas con los eventos publicados.
Quiere usar el esquema de CloudEvents 1.0 para sus eventos.

Para asociados como suscriptor

Quiere que el servicio reaccione a los eventos de cliente que se originan en Microsoft/Azure.
Quiere que el cliente reaccione a los eventos de servicio de Microsoft/Azure mediante sus aplicaciones hospedadas por la plataforma. Use las funcionalidades de enrutamiento de eventos de la plataforma para entregar eventos a la solución de cliente adecuada.
Desea un modelo sencillo en el que los clientes simplemente seleccionen el nombre del servicio como destino sin necesidad de conocer los detalles técnicos, como los puntos de conexión de la plataforma.
El sistema o plataforma admite el esquema de Cloud Events 1.0.

Recursos administrados por asociados

Como asociado, administra los siguientes tipos de recursos.

Registro de asociado

Un registro contiene información general relacionada con un asociado. Se requiere un registro al crear un espacio de nombres de asociado. Es decir, debe tener un registro de asociado para crear los recursos de Azure necesarios para integrarse con Azure Event Grid.

Los registros son globales, Es decir, no están asociados a una región de Azure determinada. Puede crear un único registro de asociado y usarlo al crear los espacios de nombres del asociado.

Canal

Un canal es un recurso anidado en un espacio de nombres de asociado. Un canal tiene dos propósitos principales:

Es el tipo de recurso que permite crear recursos de asociados en la suscripción de Azure de un cliente. Al crear un canal de tipo partner topic, se crea un tema de asociado en la suscripción de Azure de un cliente. Un tema de asociado es el recurso de un cliente al que se enrutan los eventos cuando un sistema asociado publica eventos.

Un canal tiene el mismo ciclo de vida que su tema o destino del asociado de cliente asociado. Cuando se elimina un canal de tipo partner topic, por ejemplo, se elimina el tema de asociado del cliente. Del mismo modo, si el cliente elimina el tema de asociado, se elimina el canal asociado en la suscripción de Azure.
Es un recurso que se usa para enrutar eventos. Un canal de tipo partner topic se usa para enrutar eventos al tema de asociado de un cliente. Admite dos tipos de modos de enrutamiento.
- Enrutamiento de nombres del canal. Con este tipo de enrutamiento, se publican eventos mediante un encabezado http llamado aeg-channel-name donde se proporciona el nombre del canal al que se deben enrutar los eventos. Como los canales son la representación de un asociado de temas de asociado, los eventos enrutados al canal muestran el tema de asociado del cliente. Este tipo de enrutamiento es una nueva funcionalidad que no está presente en event channels, que solo admite el enrutamiento basado en origen. El enrutamiento de nombres del canal permite más casos de uso que el enrutamiento basado en origen y es el modo de enrutamiento recomendado para elegir. Por ejemplo, con el enrutamiento de nombres del canal, un cliente puede solicitar eventos que se originen en diferentes orígenes de eventos para aterrizar en un único tema de asociado.
- Enrutamiento basado en origen. Este enfoque de enrutamiento se basa en el valor del atributo de contexto source del evento. Los orígenes se asignan a canales y cuando un evento viene con un origen, por ejemplo, del valor "A", ese evento se enruta al tema de asociado asociado al canal que contiene "A" en su propiedad de origen.
Es posible que quiera declarar los tipos de evento que se enrutan al canal y al tema de su asociado asignado. Los tipos de eventos se muestran a los clientes al crear suscripciones de eventos en el tema del asociado y se usan para seleccionar los tipos de eventos específicos que se van a enviar a un destino de controlador de eventos. Más información.

Importante

Los tipos de eventos se pueden administrar en el canal y, una vez actualizados los valores, los cambios se reflejan inmediatamente en el tema del asociado asignado.

Espacio de nombres de asociado

Un espacio de nombres de asociado es un recurso regional que tiene un punto de conexión para publicar eventos en Azure Event Grid. Los espacios de nombres de asociado contienen canales o canales de eventos (recurso heredado). Debe crear espacios de nombres de asociado en regiones en las que los clientes soliciten temas o destinos de asociados porque los canales y sus recursos de asociados correspondientes deben residir en la misma región. No puede tener un canal en una región determinada con su tema de asociado relacionado, por ejemplo, ubicado en otra región.

Los espacios de nombres de asociado contienen canales o canales de eventos. Viene determinado por el modo de enrutamiento del tema de asociado de la propiedad en el espacio de nombres. Si se establece en encabezado de nombre de canal, los canales son el único tipo de recurso que se puede crear en el espacio de nombres. Si el modo de enrutamiento de temas de asociados se establece en Atributo de origen en el evento, el espacio de nombres solo puede contener canales de eventos. Tenga en cuenta que la decisión de establecer el derecho partner topic routing mode no es una decisión entre elegir el nombre del canal o el enrutamiento basado en origen. Los canales admiten ambos. Es más bien una decisión entre usar el nuevo tipo de recurso de enrutamiento, los canales, y usar un recurso heredado, los canales de eventos.

Canal de eventos

Un canal de eventos es el recurso que se publicó por primera vez con Eventos de asociados para enrutar los eventos entrantes a temas de asociados. Los canales de eventos solo admiten el enrutamiento basado en el origen y siempre representan un tema de asociado de cliente.

Importante

Los canales de eventos están en desuso. Por lo tanto, se recomienda usar canales.

Asociados comprobados

Un asociado comprobado es una organización de asociado cuya identidad ha sido validada por Microsoft. Se recomienda encarecidamente que su organización obtenga una comprobación. Los clientes quieren interactuar con asociados que se han comprobado, ya que la comprobación proporciona más garantías de que están tratando con una organización legítima. Una vez comprobado, se beneficia de tener presencia en la Galería de Event Grid, donde los clientes pueden detectar el servicio fácilmente y tener una experiencia de primera entidad al suscribirse a los eventos, por ejemplo.

Autorización del cliente para crear temas de asociados

Los clientes le autorizan para crear temas de asociados en su suscripción de Azure. La autorización se concede para un grupo de recursos determinado en una suscripción de Azure de cliente y tiene limitación de tiempo. Debe crear el canal antes de la fecha de expiración establecida por el cliente. Debe tener documentación que sugiera al cliente un período de tiempo adecuado para configurar el sistema para enviar o recibir eventos y para crear el canal antes de que expire la autorización. Si intenta crear un canal sin autorización o después de haber expirado, se producirá un error en la creación del canal y no se creará ningún recurso en la suscripción de Azure del cliente.

Nota

Event Grid comenzó a requerir comprobaciones de autorización para crear temas de asociados en torno al 30 de junio de 2022. En la documentación debe solicitar a los clientes como requisito previo que le concedan autorización antes de crear un canal.

Importante

Un asociado comprobado no es un asociado autorizado. Incluso si Microsoft ha examinado un asociado, debe estar autorizado para poder crear un tema de asociado en la suscripción de Azure del cliente.

Activación de temas de asociado

El cliente activa el tema o el destino de asociado que ha creado para ellos. En ese momento, el estado de activación del canal cambia a Activado. Una vez activado un canal, puede empezar a publicar eventos en el punto de conexión del espacio de nombres de asociado que contiene el canal.

¿Cómo automatiza el proceso para saber cuándo puede empezar a publicar eventos para un tema de asociado determinado?

Tiene dos opciones:

Leer (sondear) el estado del canal periódicamente para comprobar si el estado de activación ha pasado de NeverActivated a Activated (Activado). Esta operación puede ser de gran uso en cálculos.
Cree una suscripción de eventos para la suscripción de Azure o el grupo de recursos que contiene los canales que desea supervisar. Recibirá eventos Microsoft.Resources.ResourceWriteSuccess cada vez que se actualice un canal. A continuación, deberá leer el estado del canal con el identificador de Azure Resource Manager proporcionado en el evento para comprobar que la actualización está relacionada con un cambio en el estado de activación a Activado.

Compartir por