- Home
- Documentation
- Events Hub
- Subscribers
Subscribers
Saiba o que são subscritores e como criá-los.Os subscritores (subscribers) são as aplicações ou parceiros que recebem os eventos distribuídos pelo Events Hub.
Para receber os eventos, os subscritores devem ser conectados aos tópicos, que são agrupados dentro dos handlers. Cada tópico pode ter diferentes contextos disponíveis para o subscritor. Portanto, quando os eventos são enviados para um tópico com definição de contexto, apenas os subscritores do tópico com aquele contexto habilitado receberão os eventos.
O Events Hub cuida de toda a segurança, garantindo aos subscritores uma fonte de mensagens confiável.
TIP
- Leia mais sobre tópicos na página de handlers.
- Entenda os contextos.
- Acesse a documentação sobre segurança para entender como funciona.
A tela Subscribers lista todos os subscritores cadastrados e permite criar novos:
Filtros
Você pode buscar um subscritor específico usando os filtros do topo da página. Eles permitem pesquisar por:
Nome do subscritor.
E-mail do desenvolvedor responsável.
Nome do handler.
Data inicial e final de criação.
Status.
Use o campo Order by para definir a ordenação da lista. Você pode escolher visualizar pela data de criação mais recente ou mais antiga, ou por ordem alfabética.
Para visualizar as informações de um subscritor específico, clique sobre o nome na listagem. Você será direcionado para a tela de Topics, onde pode editar as informações do subscritor e habilitar ou desabilitar os tópicos dos quais recebe eventos.
Criando subscritores
Para criar um subscritor, clique no botão +, no canto inferior direito da tela. O cadastro ocorre em quatro etapas:
Overview
Para iniciar o cadastro, preencha os campos:
-
Name: nome do subscritor, que deve ser único.
-
Status: estado, entre aprovado (approved), pendente (pending), rejeitado (rejected) ou cancelado (cancelled).
-
Description: campo não obrigatório para incluir uma descrição.
-
Developer: e-mail do desenvolvedor responsável pelo subscritor.
Security
Nessa etapa, você certifica a segurança na conexão entre subscritores e o Events Hub.
TIPAcesse a documentação de Segurança e Chaves para entender como funciona.
Confira a seguir as duas camadas de segurança implementadas:
- Assinatura digital
- Token estático ou dinâmico
Assinatura digital
Na distribuição de eventos aos subscritores, incluímos uma assinatura digital que permite que o subscritor valide a origem da requisição.
Para gerar essa assinatura, você precisa validar uma chave de conhecimento mútuo entre o Events Hub e o subscritor.
Para fazer isso, siga os passos:
Cadastre uma chave no campo Key.
- Se o tempo de validação expirar, clique no ícone
para reiniciar a contagem do tempo.
Para validar a chave, clique em VALIDATE KEY.
Se a validação for bem-sucedida, você verá a mensagem Post key URL validated 
na tela de Security.
IMPORTANTSe você cadastrar um subscritor sem validar a chave de conhecimento mútuo, não será possível vinculá-lo a nenhum tópico. Só é possível vincular um subscritor a um tópico após a validação da chave.
Token estático ou dinâmico
Após enviar a chave de conhecimento mútuo, você pode também incluir um token estático ou dinâmico para ser trafegado nas requisições aos subscritores.
TIPA configuração de tokens não é obrigatória. Entenda como funcionam e quais as diferenças entre estático e dinâmico na documentação de Tokens.
Para configurar um token, siga os passos:
Clique no botão CONFIGURE TOKEN.
Selecione o tipo de token entre Static e Dynamic.
No campo Location, selecione onde o token deve ser passado na requisição. As opções são header ou query param.
No campo Name, informe o nome com o qual o valor do token será passado.
A depender de qual tipo de token você selecionou, configure:
- Token SHA-256: valor do token. Você pode gerar um token randômico pelo ícone
.
Após salvar, o token será exibido apenas uma vez em uma janela modal. Copie-o e salve-o em um arquivo no seu computador. - URL OAuth: URL de geração do valor do token. Após salvar, será enviada uma requisição para a URL do subscritor para gerar o token e validar a configuração.
IMPORTANTVocê pode configurar apenas um token por subscritor.
Se algum token for configurado, a tela mostrará seus detalhes:
Topics
Na aba TOPICS, você vincula o subscritor aos tópicos de que receberá eventos. Os tópicos cadastrados são exibidos por meio dos handlers.
- Você pode procurar por handlers específicos usando o campo Keywords, que procura por termos usados no nome ou descrição do handler. Além disso, pode reordenar a lista por nome ou data de criação através do campo Order by.
Para vincular tópicos ao seu subscritor, siga os passos:
Ao escolher um handler, clique no ícone 
da coluna View Topics.
Na tela que abrir, clique no ícone 
e habilite também o contexto para o subscritor.
No campo Subscriber URL, informe a URL que receberá os eventos.
No campo Status Code, informe o código de estado de sucesso que deverá retornar.
Esse campo permite apenas códigos de 200 a 299. Você pode inserir 2xx para abranger toda a família.
O Events Hub fará uma requisição para validar a URL esperando o código informado.
WARNINGSe a URL não for validada, o subscritor será cadastrado, mas não receberá eventos.
IMPORTANTAo enviar eventos para o subscritor, o Events Hub levará em conta o código que você definiu como sucesso no campo Status Code. Se você informar o código 204 e retornar 200, o sistema entenderá que houve falha na entrega e enviará o evento para a fila de Delivery Retry. Para evitar isso, informe 2xx no campo de Status Code. Assim, qualquer código da família 200 será interpretado como sucesso.
Cada tópico selecionado será listado na seção SUBSCRIBED TOPICS. Para remover o vínculo, clique no ícone da lixeira.
A coluna STATUS indica se a URL foi validada com sucesso ou não. O ícone verde representa sucesso. O ícone cinza significa que a URL foi cadastrada, mas a validação falhou.
Review
A etapa final de registro de um subscritor exibe os dados cadastrados:
