- Home
- Documentation
- Events Hub
- Subscribers
Subscribers
Sepa qué son los suscriptores y cómo crearlos.Los suscriptores (subscribers) son las aplicaciones o socios que reciben los eventos distribuidos por el Events Hub.
Para recibir los eventos, los suscriptores deben estar conectados a los tópicos, que están agrupados dentro de los handlers. Cada tópico puede tener diferentes contextos disponibles para el suscriptor. Por lo tanto, cuando los eventos se envían a un tópico con definición de contexto, solo los suscriptores del tópico con ese contexto habilitado recibirán los eventos.
El Events Hub se encarga de toda la seguridad, garantizando a los suscriptores una fuente confiable de mensajes.
TIP
- Lea más sobre tópicos en la página de handlers.
- Entienda los contextos.
- Acceda a la documentación sobre seguridad para entender cómo funciona.
La pantalla Subscribers lista todos los suscriptores registrados y permite crear nuevos:
Filtros
Puede buscar un suscriptor específico usando los filtros en la parte superior de la página. Estos permiten buscar por:
- Nombre del suscriptor.
- Correo electrónico del desarrollador responsable.
- Nombre del handler.
- Fecha inicial y final de creación.
- Estado.
Use el campo Order by para definir el orden de la lista. Puede elegir visualizar por la fecha de creación más reciente o más antigua, o por orden alfabético.
Para visualizar la información de un suscriptor específico, haga clic sobre el nombre en la lista. Será dirigido a la pantalla de Topics, donde puede editar la información del suscriptor y habilitar o deshabilitar los tópicos de los que recibe eventos.
Creando suscriptores
Para crear un suscriptor, haga clic en el botón +, en la esquina inferior derecha de la pantalla. El registro se realiza en cuatro etapas:
Overview
Para iniciar el registro, complete los campos:
- Name: nombre del suscriptor, que debe ser único.
- Status: estado, entre aprobado (approved), pendiente (pending), rechazado (rejected) o cancelado (cancelled).
- Description: campo no obligatorio para incluir una descripción.
- Developer: correo electrónico del desarrollador responsable del suscriptor.
Security
En esta etapa, certifica la seguridad en la conexión entre suscriptores y el Events Hub.
TIPAcceda a la documentación de Seguridad y Claves para entender cómo funciona.
A continuación, las dos capas de seguridad implementadas:
- Firma digital
- Token estático o dinámico
Firma digital
En la distribución de eventos a los suscriptores, incluimos una firma digital que permite que el suscriptor valide el origen de la solicitud.
Para generar esta firma, necesita validar una clave de conocimiento mutuo entre el Events Hub y el suscriptor.
Para hacerlo, siga los pasos:
Registre una clave en el campo Key.
- Si el tiempo de validación expira, haga clic en el ícono
para reiniciar el conteo del tiempo.
Para validar la clave, haga clic en VALIDATE KEY.
Si la validación es exitosa, verá el mensaje Post key URL validated 
en la pantalla de Security.
IMPORTANTSi registra un suscriptor sin validar la clave de conocimiento mutuo, no será posible vincularlo a ningún tópico. Solo es posible vincular un suscriptor a un tópico después de la validación de la clave.
Token estático o dinámico
Después de enviar la clave de conocimiento mutuo, también puede incluir un token estático o dinámico para ser transmitido en las solicitudes a los suscriptores.
TIPLa configuración de tokens no es obligatoria. Entienda cómo funcionan y cuáles son las diferencias entre estático y dinámico en la documentación de Tokens.
Para configurar un token, siga los pasos:
Haga clic en el botón CONFIGURE TOKEN.
Seleccione el tipo de token entre Static y Dynamic.
En el campo Location, seleccione dónde debe pasarse el token en la solicitud. Las opciones son header o query param.
En el campo Name, informe el nombre con el que se pasará el valor del token.
Dependiendo del tipo de token seleccionado, configure:
- Token SHA-256: valor del token. Puede generar un token aleatorio con el ícono
.
Después de guardar, el token se mostrará solo una vez en una ventana modal. Cópielo y guárdelo en un archivo en su computadora. - URL OAuth: URL de generación del valor del token. Después de guardar, se enviará una solicitud a la URL del suscriptor para generar el token y validar la configuración.
IMPORTANTSolo puede configurar un token por suscriptor.
Si se configura algún token, la pantalla mostrará sus detalles:
Topics
En la pestaña TOPICS, vincula el suscriptor a los tópicos de los que recibirá eventos. Los tópicos registrados se muestran a través de los handlers.
- Puede buscar handlers específicos usando el campo Keywords, que busca términos usados en el nombre o descripción del handler. Además, puede reordenar la lista por nombre o fecha de creación a través del campo Order by.
Para vincular tópicos a su suscriptor, siga los pasos:
Al elegir un handler, haga clic en el ícono 
de la columna View Topics.
En la pantalla que se abrirá, haga clic en el ícono 
y habilite también el contexto para el suscriptor.
En el campo Subscriber URL, informe la URL que recibirá los eventos.
En el campo Status Code, informe el código de estado de éxito que debe devolver.
Este campo permite solo códigos de 200 a 299. Puede insertar 2xx para abarcar toda la familia.
El Events Hub hará una solicitud para validar la URL esperando el código informado.
WARNINGSi la URL no es validada, el suscriptor será registrado, pero no recibirá eventos.
IMPORTANTAl enviar eventos al suscriptor, el Events Hub tomará en cuenta el código que definió como éxito en el campo Status Code. Si informa el código 204 y devuelve 200, el sistema entenderá que hubo un fallo en la entrega y enviará el evento a la cola de Delivery Retry. Para evitar esto, informe 2xx en el campo de Status Code. Así, cualquier código de la familia 200 será interpretado como éxito.
Cada tópico seleccionado será listado en la sección SUBSCRIBED TOPICS. Para eliminar el vínculo, haga clic en el ícono de la papelera.
La columna STATUS indica si la URL fue validada con éxito o no. El ícono verde representa éxito. El ícono gris significa que la URL fue registrada, pero la validación falló.
Review
La etapa final de registro de un suscriptor muestra los datos registrados:
