Guia rápido do Events Hub

O Events Hub permite gerenciar uma arquitetura de distribuição de eventos a partir de uma interface low-code, em que publicadores e subscritores de eventos são cadastrados e gerenciados de forma completamente independente.

Para que o Events Hub saiba quais subscritores devem receber quais eventos, existem rotas de publicação e subscrição — formando um canal de recebimento e distribuição de eventos. Essas rotas são definidas na configuração de contextos, handlers e tópicos, cada um com um path específico que é concatenado à URL de publicação. Quando os publicadores enviam requisições ao Events Hub, garantimos que ela será distribuída somente aos subscritores cadastrados para receber o evento.

Além do gerenciamento de publicação e subscrição, o Events Hub garante a entrega dos eventos aos subscritores por meio de: acompanhamento do estado do envio; tentativas automáticas de entrega; e, se houver falha, possibilidade de reenvio manual pela própria interface.

Para completar, cuidamos da segurança durante todas as etapas de gerenciamento de eventos. Interceptores de segurança podem ser adicionados ao fluxo de recebimento de eventos para controlar o acesso de publicadores, que podem ser validados por um servidor externo. Em relação aos subscritores, trafegamos uma assinatura digital junto com todos os eventos distribuídos, permitindo a validação da origem das requisições. Um token de segurança estático ou dinâmico também pode ser configurado para que seja trafegado.

Tópicos, handlers e contextos são os elementos que formam o canal de publicação e subscrição de eventos. É por meio deles que o Events Hub organiza as rotas de recebimento e distribuição dos eventos, assegurando que as mensagens cheguem aos devidos subscritores.

Como o tópico é o último marcador da URL de publicação, é através dele que o Events Hub encontra os subscritores que deverão receber cada evento. Os publicadores enviam requisições ao Events Hub para a URL de publicação do tópico e o Events Hub encaminhará os eventos para todos os subscritores ativos para o tópico.

Handlers e contextos existem para facilitar o gerenciamento e uso dos tópicos:

Como configurar tópicos, handlers e contextos?

Handlers são criados e gerenciados na tela Handlers.

Durante o cadastro ou edição de handlers, você pode criar novos tópicos ou editar os existentes.

Os contextos são criados na tela Contexts e habilitados para cada tópico no processo de criação ou edição de handlers. Ao vincular publicadores e subscritores a um tópico, o usuário define quais dos contextos habilitados para o tópico serão disponibilizados para o publicador e para o subscritor. Os endpoints de autorização de publicadores são definidos para cada contexto na tela Authorizations.

O Events Hub permite que os dois extremos da integração de eventos — os produtores e os consumidores — sejam cadastrados de forma intuitiva e completamente independente.

Os publicadores são cadastrados na tela Publishers. Eles podem ser cadastrados do zero, mas também é possível importar uma app da Sensedia API Platform. No processo de cadastro, cada publicador é vinculado aos tópicos aos quais poderá enviar requisições e, dentre os contextos habilitados para o tópico, é preciso escolher quais serão disponibilizados para o publicador.

Os subscritores são cadastrados na tela Subscribers. No processo de cadastro, cada subscritor é inscrito nos devidos tópicos dos quais receberá eventos e, dentre os contextos habilitados para o tópico, é preciso escolher quais serão disponibilizados para o subscritor.

No processo de cadastro de subscritores, é necessário configurar para cada tópico inscrito uma URL que receberá os eventos. Com isso, um mesmo subscritor pode receber eventos em URLs diferentes.

Na tela Policies você pode definir a segurança que será aplicada aos publicadores e a configuração de entrega de eventos aos subscritores, que compreende a quantidade de tentativas automáticas que deverão ser feitas.

A política de segurança é definida por interceptores para validar a identidade dos publicadores (opções: validação de OAuth, JWT, Client ID, Access Token). Também é possível utilizar um interceptor para filtrar o acesso de publicadores por IP.

As configurações de entrega de eventos aos subscritores incluem a quantidade de tentativas automáticas que serão realizadas caso o primeiro envio falhe, o tempo limite de requisição e os códigos de estado HTTP de retorno que devem disparar uma nova tentativa automática.

As políticas cadastradas na tela Policies são aplicadas aos handlers no processo de criação/edição de handlers. Isso significa que todos os tópicos de um handler utilizam a mesma política. O servidor externo de autorização de publicadores é definido a nível de contexto na tela Authorizations.

O Events Hub implementa camadas de segurança que permitem com que os subscritores verifiquem a procedência das mensagens recebidas.

Em primeiro lugar, trafegamos uma assinatura digital em todas as requisições aos subscritores. Essa assinatura é um token JWT gerado a partir de uma chave de conhecimento mútuo entre subscritores e o Events Hub, enviada no processo de cadastro de subscritores.

Como um outro requerimento de segurança para os subscritores, é possível configurar um token estático ou dinâmico que também deverá ser trafegado nas requisições.

A tela Event Status exibe a lista de eventos recebidos dos publicadores.

Para cada item da lista, é possível ver detalhes a respeito das tentativas de distribuição do evento aos subscritores.

Também é possível acessar uma tela com o histórico das tentativas de entrega.

As tentativas automáticas de entrega seguem um algoritmo de recuo exponencial para aumentar as chances de sucesso. Contudo, se todos os envios a um subscritor fracassarem, é possível tentar uma entrega manual na tela Delivery Retry.