Freigeben über


Webhook-Ereignishandler für die Pushübermittlung von Namespacethemen

Sie können einen Webhook-Endpunkt einrichten, um Ereignisse in einem bestimmten Namespacethema zu behandeln, indem Sie es abonnieren. Jeder öffentliche Endpunkt kann als Ereignishandler verwendet werden, wenn er Verschlüsselung während der Übertragung verwendet (HTTPS), Ereignisse in unterstützten CloudEvents-Metadatenformaten lesen und Webhooks überprüfen kann.

Sie müssen Ihren Webhook nicht in Azure hosten. Sie können also einen Webhook verwenden, der an anderer Stelle gehostet wird, um Ereignisse in Ihrer Anwendung zu behandeln. So haben Sie die Flexibilität, einen Webhook bei jedem Dienstanbieter auszuwählen, der Ihren spezifischen Anforderungen am besten entspricht.

Webhookvalidierung

Wenn Ihr Webhook-Endpunkt böswilligen Akteuren bekannt ist, könnten diese Angriffsvektoren ausnutzen und beispielsweise Denial-of-Service-Angriffe starten. Um Ihren Webhook vor unerwarteten Ereignisübermittlungen zu schützen, muss Ihr Webhook angeben, ob er der Ereignisübermittlung zustimmt. Unerwartete Übermittlungen können auch auftreten, wenn jemand versehentlich ein Ereignisabonnement für Ihren Endpunkt erstellt. Aus diesem Grund muss Ihr Endpunkt die Webhooküberprüfung mit dem Missbrauchsschutz für Webhooks von CloudEvents behandeln. Diesem Ansatz folgend sendet Event Grid im Rahmen der Ereignisabonnementerstellung eine Überprüfungsanforderung gefolgt von einer ordnungsgemäßen Überprüfungsantwort. Wenn die Überprüfung nicht erfolgreich war, wird das Ereignisabonnement nicht erstellt.

Wichtig

Event Grid unterstützt beim Überprüfen von Webhooks die folgenden Funktionen nicht:

  • WebHook-Request-Callback. Das bedeutet, dass Sie bzw. Ihr Webhook nicht asynchron auf die Überprüfungsanforderung von Event Grid antworten können.
  • WebHook-Request-Rate. Event Grid fordert also keine Datenrate für die Kommunikation mit Ihrem Webhook-Endpunkt an. Wenn Ihr Webhook mit einem WebHook-Allowed-Rate-Header antwortet, wird er ignoriert.

webhooks

Unter Übermitteln von Ereignissen an Webhooks mithilfe von Namespacethemen: Azure-Befehlszeilenschnittstelle finden Sie ausführliche Anweisungen zum Veröffentlichen von Ereignissen in Azure Event Grid im CloudEvents-JSON-Format und zur Übermittlung dieser Ereignisse mithilfe des Pushübermittlungsmodells.