Contexts

Contextos son divisiones lógicas que funcionan como marcadores de la URL de publicación de eventos. Permiten reutilizar tópicos en diferentes escenarios.

El servidor externo de autorización se define por contexto. Esto significa que cuando dos contextos diferentes están disponibles para un tópico, es posible utilizar dos endpoints distintos de autorización para el mismo tópico.

La pantalla Contexts lista todos los contextos registrados en su Events Hub:

Cómo funciona

Para entender cómo funcionan los contextos, es importante saber cómo el Events Hub coordina la publicación y suscripción a eventos:

• Los publicadores de eventos (publishers) envían solicitudes al Events Hub, que las distribuye a todos los suscriptores (subscribers) registrados.
• Para garantizar que los eventos del publicador se entreguen a los suscriptores correctos, el Events Hub utiliza tópicos.
• Cada tópico puede tener varios suscriptores.
• Cuando un publicador envía un evento a un tópico específico, el Events Hub distribuye ese evento a todos los suscriptores vinculados al tópico.

URL de publicación de eventos

Para publicar eventos, necesita crear una ruta (URL) que sirva como canal de envío de eventos de un publicador al Events Hub.

Esta URL se forma por URL base + context + handler + topic:

1. URL base: es definida por el Events Hub. Incluye la dirección de la interfaz de cada cliente + event-receiver + un código único (hash).
2. Contexto, handler y tópico: son creados por usted. Ayudan a organizar y gestionar diferentes canales de publicación.
   • Tópicos es el nivel más específico.
   • Handlers son los agregadores de tópicos, sirviendo como una capa lógica de agrupamiento.
   • Contextos añaden un nivel más de agrupamiento, permitiendo usar el mismo tópico en diferentes situaciones. Para habilitar un tópico a un publicador, necesita activarlo en al menos un contexto.

Ejemplo

Imagine que desea crear un flujo de publicación de varios tipos de alerta y probarlo sin notificar a los suscriptores. Para hacerlo, puede:

Crear un handler llamado "Alerts", con el path /alerts.

Registrar tópicos agrupados en el handler. Por ejemplo: /latency para alertas de latencia y api-update para alertas de actualización de las APIs.

Crear un contexto para pruebas (por ejemplo, testing) y habilitarlo para el tópico que desea probar para que los suscriptores no reciban alertas.

• Para registrar suscriptores en el contexto de prueba, debe vincularlos al tópico y habilitarlos solo para el contexto testing.

• Si no registra ningún contexto, el Events Hub define "Default" como predeterminado, y ningún marcador se añade a la URL de publicación. Por lo tanto, las solicitudes para el tópico latency o api-update se enviarán a <url-base>/alerts/latency/<url-base>/alerts/api-update y todos los suscriptores activos en él recibirán los eventos.

Teniendo en cuenta el ejemplo anterior, las URLs de publicación para el tópico latency serán:

• Contexto Default: <url-base>/alerts/latency
• Contexto Testing: <url-base>/testing/alerts/latency

La mayor ventaja de usar diferentes contextos es poder reutilizar las configuraciones de políticas de seguridad e intentos de entrega definidas en el handler, sin necesidad de crear nuevos tópicos. Y como los endpoints de autorización se definen por contexto, puede usar un mock de autorización para pruebas mientras mantiene la autorización del contexto predeterminado sin cambios.

IMPORTANT

Los contextos son divisiones lógicas que facilitan la creación y mantenimiento de tópicos, permitiendo reutilizarlos en diferentes escenarios. No son entornos físicamente separados unos de otros.

Esto significa que, si utiliza el contexto "Default" para eventos productivos y el contexto "Testing" para eventos de prueba, puede controlar los publicadores, suscriptores y endpoints de autorización para cada contexto. Sin embargo, todos los eventos recibidos y distribuidos en el Events Hub comparten la misma infraestructura.

Pruebas que sobrecarguen la infraestructura, incluso realizadas en el contexto de prueba, podrán afectar la recepción y distribución de eventos en los otros contextos.

Autorización

Los endpoints que validan los publicadores se definen para cada contexto. Esto se realiza en la pantalla Authorizations, que contiene dos secciones: OAUTH y JWT. En ambas se muestran todos los contextos registrados en el Events Hub, indicando la URL de autorización que está definida para cada uno.

El uso de interceptores de seguridad es opcional. Sin embargo, si añade políticas a su handler, necesita configurar la URL de la autorización vinculada al interceptor. Con excepción del "IP Filtering Validation", todos dependen de esta configuración para funcionar.

NOTE

Vea cómo usar la Sensedia API Platform para autorización de los publicadores.

Vincular contextos

Los contextos se vinculan a los tópicos a través de la pestaña Topics en la creación o edición de handlers. Para publicar eventos, relaciona los tópicos y sus contextos a publicadores y suscriptores. Esto ocurre de la siguiente manera:

Creando contextos

Puede crear hasta 5 contextos en el Events Hub. El contexto "Default" es predeterminado y no puede ser editado o eliminado.

TIP

Al alcanzar el límite de contextos, el botón + será deshabilitado, impidiendo el registro de nuevos contextos. Si necesita un nuevo contexto, deberá eliminar uno de los existentes.

Para crear un nuevo contexto, haga clic en el botón +. Complete los campos:

• Name: nombre único identificador del contexto.
• Path: ruta del contexto, que servirá como marcador de la URL de publicación.
• Description: descripción opcional para el contexto.

Después de registrarlo, el contexto se mostrará en la etapa TOPICS de creación/edición de handlers y podrá habilitarse para cualquier tópico.

Overview de contextos

Al hacer clic sobre el nombre de un contexto, verá los tópicos vinculados a él. En esta pantalla, es posible:

• Buscar un tópico usando el campo Keywords. La búsqueda busca por nombre o descripción de los tópicos y nombre del handler.
• Editar el contexto con el botón EDIT CONTEXT. Esta opción permite editar nombre, path y descripción del contexto.
• Ver detalles de un tópico haciendo clic sobre el nombre en la columna Handler. Al hacerlo, será dirigido a la pestaña TOPICS, en la página de Handlers.
• Eliminar el contexto haciendo clic en el ícono de la papelera.

NOTE

Solo es posible eliminar contextos que no están asociados a ningún tópico. Si lo están, deberá deshabilitar el contexto en cada tópico para poder eliminarlo.