Suscripción a eventos publicados por un asociado con Azure Event Grid
En este artículo se describen los pasos para suscribirse a eventos que se originan en un sistema propiedad o administrado por un asociado (SaaS, Enterprise Resource Planning (ERP), etc.).
Importante
Si no está familiarizado con la característica Eventos de partners, consulte Información general sobre eventos de asociados para comprender la lógica de los pasos descritos en este artículo.
Pasos de alto nivel
Estos son los pasos que un suscriptor debe realizar para recibir eventos de un asociado.
- Registre el proveedor de recursos de Event Grid con su suscripción de Azure.
- Autorice al asociado para crear un tema de asociado en el grupo de recursos.
- Solicite al asociado que habilite el flujo de eventos a un tema de asociado.
- Active el tema del asociado para que los eventos empiecen a fluir al tema del asociado.
- Suscripción a eventos.
Registro del proveedor de recursos de Event Grid
A menos que haya usado Event Grid antes, deberá registrar el proveedor de recursos de Event Grid. Si ha usado Event Grid anteriormente, vaya a la siguiente sección.
En Azure Portal, realice los siguientes pasos:
En el menú de la izquierda, seleccione Suscripciones.
Seleccione la suscripción que desea usar para Event Grid en la lista de suscripciones.
En la página Suscripción, seleccione Proveedores de recursos en Configuración del menú izquierdo.
Busque Microsoft.EventGrid y confirme que el estado es No registrado.
Seleccione Microsoft.EventGrid en la lista de proveedores.
Seleccione Registrar en la barra de comandos.
Actualice para asegurarse de que el estado de Microsoft.EventGrid se cambia a Registrado.
Autorizar al asociado para crear un tema de asociado
Debe conceder su consentimiento al asociado para crear temas de asociados en un grupo de recursos que designe. Esta autorización tiene una hora de expiración. Es efectivo para el período de tiempo que especifique entre 1 y 365 días.
Importante
Para obtener una mayor postura de seguridad, especifique el tiempo de expiración mínimo que ofrece al asociado suficiente tiempo para configurar los eventos para fluir a Event Grid y aprovisionar el tema del asociado. El asociado no podrá crear recursos (temas de asociados) en su suscripción de Azure después de la fecha de expiración de la autorización.
En el ejemplo siguiente se muestra cómo crear un recurso de configuración de asociado que contiene la autorización del asociado. Debe identificar al asociado proporcionando su identificador de registro de asociado o el nombre del asociado. Ambos se pueden obtener de su asociado, pero solo se requiere uno de ellos. Para su comodidad, los ejemplos siguientes dejan una hora de expiración de ejemplo en el formato UTC.
Azure Portal
Inicie sesión en Azure Portal.
En la barra de búsqueda de la parte superior, escriba Configuraciones de asociados y seleccione Configuraciones de asociados de Event Grid en Servicios en los resultados.
En la página Event Grid Partner Configurations (Configuraciones de asociados de Event Grid), seleccione el botón Create Event Grid partner configuration (Crear configuración de asociado de Event Grid) en la página (o) seleccione + Crear en la barra de comandos.
En la página Create Partner Configuration (Crear configuración de asociado), siga estos pasos:
En la sección Detalles del proyecto, seleccione la suscripción de Azure y el grupo de recursos en el que quiere permitir que el asociado cree un tema de asociado.
En la sección Partner Authorizations (Autorizaciones de asociado), especifique una hora de expiración predeterminada para las autorizaciones de asociados definidas en esta configuración.
Para proporcionar la autorización de un asociado para crear temas de asociados en el grupo de recursos especificado, seleccione el vínculo + Partner Authorizations (+ Autorizaciones de asociado).
En la página Add partner authorization to create resources (Agregar autorización de asociado para crear recursos), verá una lista de asociados comprobados. Un asociado comprobado es un asociado cuya identidad ha sido validada por Microsoft. Puede seleccionar un asociado comprobado y seleccionar el botón Agregar en la parte inferior para conceder al asociado la autorización para agregar un tema de asociado en el grupo de recursos. Esta autorización es efectiva hasta el momento de expiración.
También tiene una opción para autorizar a un asociado no comprobado. A menos que el asociado sea una entidad que conozca bien, por ejemplo, una organización dentro de su empresa, se recomienda encarecidamente que solo trabaje con asociados comprobados. Si aún no se ha comprobado el asociado, recomiéndeles que se verifiquen pidiéndoles que se comuniquen con el equipo de Event Grid en askgrid@microsoft.com.
- Para autorizar a un asociado comprobado:
Seleccione el asociado de la lista.
Especifique la hora de expiración de la autorización.
Seleccione Agregar.
- Para autorizar a un asociado no comprobado, seleccione Authorize non-verified partner (Autorizar asociado no comprobado) y siga estos pasos:
Escriba el identificador de registro del asociado. Debe pedir el identificador al asociado.
Especifique la hora de expiración de la autorización.
Seleccione Agregar.
Importante
El asociado no podrá crear recursos (temas de asociados) en su suscripción de Azure después de la fecha de expiración de la autorización.
- Para autorizar a un asociado comprobado:
De nuevo en la página Create Partner Configuration (Crear configuración de asociado), compruebe que el asociado se ha agregado a la lista de autorización del asociado en la parte inferior.
En la parte inferior de la página, seleccione Revisar y crear.
En la página Revisión, revise toda la configuración y seleccione Crear para crear el registro de asociado.
Solicite al asociado que habilite el flujo de eventos a un tema de asociado
Esta es la lista de asociados y un vínculo para enviar una solicitud para habilitar el flujo de eventos a un tema de asociado.
Activación de un tema de asociado
En la barra de búsqueda de Azure Portal, busque y seleccione Temas de asociado de Event Grid.
En la página Temas de asociado de Event Grid, seleccione el tema del asociado en la lista.
Revise el mensaje de activación y seleccione Activar en la página o en la barra de comandos para activar el tema de asociado antes de la hora de expiración mencionada en la página.
Confirme que el estado de activación está establecido en Activado y, a continuación, cree suscripciones de eventos para el tema del asociado; para ello, seleccione + Suscripción de eventos en la barra de comandos.
Suscripción a los eventos
En primer lugar, cree un controlador de eventos que controlará los eventos del asociado. Por ejemplo, cree un centro de eventos, una cola o tema de Service Bus o una función de Azure. A continuación, cree una suscripción de eventos para el tema del asociado mediante el controlador de eventos que ha creado.
Crear un controlador de eventos
Necesitará un controlador de eventos para probar un tema de asociado. Diríjase a su suscripción a Azure y arranque un servicio que se admita como controlador de eventos, como una instancia de Azure Functions. Para obtener un ejemplo, consulte muestra del Visor de Event Grid que puede usar como controlador de eventos a través de webhooks.
Suscripción al tema del asociado
La suscripción al tema de asociado indica a Event Grid dónde quiere que se entreguen los eventos de asociados.
En Azure Portal, escriba Temas de asociado de Event Grid en el cuadro de búsqueda y seleccione Temas de asociado de Event Grid.
En la página Temas de asociado de Event Grid, seleccione el tema del asociado en la lista.
En la página Tema de asociado de Event Grid del tema del asociado, seleccione + Suscripción de eventos en la barra de comandos.
En la página Crear suscripción de eventos, realice los siguientes pasos:
Escriba un nombre para la suscripción a eventos.
En Filtrar a tipos de eventos, seleccione los tipos de eventos que recibirá la suscripción.
En Tipo de punto de conexión, seleccione un servicio de Azure (Azure Functions, colas de Storage, Event Hubs, cola de Service Bus, tema de Service Bus, Conexiones híbridas, etc.), o webhook.
Haga clic en el vínculo Seleccione un punto de conexión. En este ejemplo, vamos a usar el destino o el punto de conexión de Azure Event Hubs.
En la página Seleccionar centro de eventos, seleccione configuraciones para el punto de conexión y, a continuación, seleccione Confirmar selección.
De nuevo en la página Crear suscripción de eventos, seleccione Crear.
Pasos siguientes
Para obtener más información, consulte los siguientes artículos sobre la característica Eventos de partners: