Partilhar via


Manipulador de eventos Webhook para entrega por push do tópico de namespace (Visualização)

Você pode configurar um ponto de extremidade webhook para manipular eventos em um tópico de namespace específico assinando-o. Qualquer ponto de extremidade público pode ser usado como um manipulador de eventos se usar criptografia em trânsito (HTTPS), puder ler eventos que usam um formato de metadados do CloudEvents suportado e manipular a validação do webhook.

Você não precisa hospedar seu webhook no Azure, o que significa que você pode usar um webhook hospedado em outro lugar para manipular eventos em seu aplicativo. Dá-lhe a flexibilidade de escolher um webhook em qualquer fornecedor de serviços que melhor se adapte às suas necessidades e requisitos específicos.

Validação de Webhook

Se o ponto de extremidade do webhook for conhecido por agentes mal-intencionados, eles poderão explorar vetores de ataque e, por exemplo, lançar ataques de negação de serviço. Para proteger seu webhook da entrega inesperada de eventos, ele precisa indicar se concorda com a entrega do evento. Entregas inesperadas podem até acontecer alguém que cria inadvertidamente uma assinatura de evento para o seu endpoint. Para esse fim, seu endpoint deve lidar com a validação do webhook usando a proteção contra abuso do CloudEvents para webhooks. Seguindo essa abordagem e como parte da criação da assinatura do evento, a Grade de Eventos envia uma solicitação de validação que é seguida por uma resposta de validação adequada. Se a validação não for aprovada, a criação da assinatura do evento falhará.

Importante

A Grade de Eventos não oferece suporte à seguinte funcionalidade ao validar webhooks:

  • WebHook-Request-Callback. Isso significa que você ou seu webhook não podem responder de forma assíncrona à solicitação de validação da Grade de Eventos.
  • WebHook-Request-Rate. Ou seja, a Grade de Eventos não solicita uma taxa de dados na qual ela se comunica com seu ponto de extremidade webhook. Se o seu webhook responder com um WebHook-Allowed-Ratecabeçalho, ele será ignorado.

Webhooks

Consulte Entregar eventos para webhooks usando tópicos de namespace - CLI do Azure, que fornece instruções passo a passo para publicar eventos na Grade de Eventos do Azure no formato JSON CloudEvents e entregar esses eventos usando o modelo de entrega por push.

Próximos passos