Abonnieren von Ereignissen und Warten auf Ereignisse zum Ausführen von Workflows mithilfe von HTTP-Webhooks in Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Anstelle eines Triggers, der regelmäßig einen Dienstendpunkt überprüft oder abfragt, oder einer Aktion, die diesen Endpunkt aufruft, können Sie einen HTTP-Webhooktrigger oder eine Aktion verwenden, der bzw. die einen Dienstendpunkt abonniert, auf bestimmte Ereignisse wartet und bestimmte Aktionen in Ihrem Workflow ausführt.

Hier sind einige Beispiele für webhook-basierte Workflows:

• Warten, dass ein Ereignis von Azure Event Hubs eintrifft, bevor eine Workflowausführung ausgelöst wird
• Warten auf eine Genehmigung, bevor ein Workflow fortgesetzt wird.

In diesem Handbuch wird gezeigt, wie Sie den HTTP-Webhook-Trigger und die HTTP-Webhook-Aktion verwenden, damit Ihr Workflow Ereignisse an einem Dienstendpunkt empfangen und darauf reagieren kann.

Wie funktionieren Webhooks?

Ein Webhooktrigger ist ereignisbasiert und erfordert nicht, dass regelmäßig auf neue Daten oder Ereignisse geprüft wird oder diese abgerufen werden. Nachdem Sie einen Webhooktrigger zu einem leeren Workflow hinzugefügt und dann den Workflow gespeichert haben oder nachdem Sie eine deaktivierte Logik-App-Ressource erneut aktiviert haben, abonniert der Webhooktrigger den angegebenen Dienstendpunkt. Dazu registriert er eine Rückruf-URL bei diesem Endpunkt. Der Trigger wartet dann darauf, dass der Dienstendpunkt die URL aufruft, wodurch der Trigger ausgelöst und der Workflow gestartet wird. Ähnlich wie der Anforderungstrigger wird ein Webhooktrigger sofort ausgelöst.

Der Webhooktrigger bleibt auch beim Dienstendpunkt abonniert, es sei denn, Sie führen manuell die folgenden Aktionen aus:

• Ändern der Parameterwerte des Triggers
• Löschen des Triggers und Speichern des Workflows
• Deaktivieren der Logik-App-Ressource

Ähnlich wie beim Webhook-Trigger ist auch eine Webhook-Aktion ereignisbasiert. Nachdem Sie eine Webhookaktion zu einem vorhandenen Workflow hinzugefügt und dann den Workflow gespeichert haben oder nachdem Sie eine deaktivierte Logik-App-Ressource erneut aktiviert haben, abonniert die Webhookaktion den angegebenen Dienstendpunkt. Dazu registriert sie eine Rückruf-URL bei diesem Endpunkt. Wenn der Workflow ausgeführt wird, hält die Webhookaktion den Workflow an und wartet, bis der Dienstendpunkt die URL aufruft, bevor der Workflow die Ausführung fortsetzt. Eine Webhookaktion kündigt das Abonnement für den Dienstendpunkt, wenn die folgenden Bedingungen auftreten:

• Die Webhookaktion wurde erfolgreich abgeschlossen.
• Die Workflowausführung wird während des Wartens auf eine Antwort abgebrochen.
• Vor dem Timeout einer Workflowausführung
• Sie ändern die Parameterwerte von Webhookaktionen, die von einem Webhooktrigger als Eingaben verwendet werden.

Beispielsweise ist die E-Mail-Aktion des Office 365 Outlook-Connectors zum Senden der Genehmigung ein Beispiel für eine Webhook-Aktion, die diesem Muster folgt. Sie können dieses Muster mithilfe der Webhookaktion auf jeden Dienst erweitern.

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Webhooks und Abonnements
• Erstellen von benutzerdefinierten APIs, die einen Webhook unterstützen

Informationen zu Verschlüsselung, Sicherheit und Autorisierung für eingehende Aufrufe an Ihre Logik-App, z. B. Transport Layer Security (TLS) oder die offene Microsoft Entra ID-Authentifizierung, finden Sie unter Access für eingehende Anrufe zu anforderungsbasierten Triggern.

Technische Referenz für den Connector

Weitere Informationen zu Trigger- und Aktionsparametern finden Sie unter HTTP-Webhookparameter.

Voraussetzungen

• Ein Azure-Konto und ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Die URL für einen bereits bereitgestellten Endpunkt oder eine bereits bereitgestellte API, die das Abonnieren- und Abbestellen-Muster für Webhook-Trigger in Workflows oder Webhook-Aktionen in Workflows unterstützt, entsprechend.

• Der Workflow der Standard- oder Verbrauchs-Logik-App, in dem auf bestimmte Ereignisse am Zielendpunkt gewartet werden soll.

  Um mit dem HTTP-Webhook-Trigger zu beginnen, erstellen Sie eine Logik-App mit einem leeren Workflow.

  Um die HTTP-Webhook-Aktion zu verwenden, starten Sie Den Workflow mit jedem gewünschten Trigger. In diesem Beispiel wird der HTTP-Trigger als erster Schritt verwendet.

Hinzufügen eines HTTP-Webhooktriggers

Dieser integrierte Trigger ruft den Abonnementendpunkt im Zieldienst auf und registriert eine Rückruf-URL beim Zieldienst. Ihr Workflow wartet dann darauf, dass der Zieldienst eine HTTP POST-Anforderung an die Rückruf-URL sendet. Wenn dieses Ereignis eintritt, wird der Trigger ausgelöst und übergibt alle Daten in der Anforderung an den Workflow.

Durch das Speichern Ihres Workflows wird der Abonnementendpunkt im Zieldienst aufgerufen und die Rückruf-URL registriert. Ihr Workflow wartet dann darauf, dass der Zieldienst eine HTTP POST-Anforderung an die Rückruf-URL sendet. Wenn dieses Ereignis eintritt, wird der Trigger ausgelöst und übergibt alle Daten in der Anforderung an den Workflow. Wenn dieser Vorgang erfolgreich abgeschlossen wurde, kündigt der Trigger das Abonnement des Endpunkts, und Ihr Workflow fährt mit der nächsten Aktion fort.

Hinzufügen einer HTTP-Webhookaktion

Diese integrierte Aktion ruft den Abonnementendpunkt im Zieldienst auf und registriert eine Rückruf-URL beim Zieldienst. Ihr Workflow pausiert und wartet dann darauf, dass der Zieldienst eine HTTP POST-Anforderung an die Rückruf-URL sendet. Wenn dieses Ereignis eintritt, übergibt die Aktion alle Daten in der Anforderung an den Workflow. Wenn der Vorgang erfolgreich abgeschlossen wurde, kündigt die Aktion das Abonnement des Endpunkts, und Ihr Workflow fährt mit der nächsten Aktion fort.

Wenn diese Aktion ausgeführt wird, ruft Ihr Workflow den Abonnementendpunkt im Zieldienst auf und registriert die Rückruf-URL. Ihr Workflow pausiert und wartet dann darauf, dass der Zieldienst eine HTTP POST-Anforderung an die Rückruf-URL sendet. Wenn dieses Ereignis eintritt, übergibt die Aktion alle Daten in der Anforderung an den Workflow. Wenn der Vorgang erfolgreich abgeschlossen wurde, kündigt die Aktion das Abonnement des Endpunkts, und Ihr Workflow fährt mit der nächsten Aktion fort.

Ausgaben aus Triggern und Aktionen

Hier sind weitere Informationen zu den Ausgaben eines HTTP-Webhook-Triggers oder einer Aktion, die diese Informationen zurückgibt:

Generieren einer Rückruf-URL mit sekundärem Zugriffsschlüssel

Ein Logik-App-Workflow verfügt über zwei Zugriffstasten: primär und sekundär. Standardmäßig verwendet Azure Logic Apps den Primärschlüssel, um die Rückruf-URL für den HTTP-Webhook-Trigger zu generieren.

Führen Sie die folgenden Schritte aus, um den sekundären Schlüssel stattdessen für die Generierung von Rückruf-URLs zu verwenden:

1. Wechseln Sie im Workflow-Designer zur Codeansicht.

2. Suchen Sie in der HttpWebhook Triggerdefinition den accessKeyType Parameter.

3. Geben Sie das Wort Secondary als Parameterwert an.

4. Denken Sie daran, Ihre Änderungen zu speichern.

Das folgende Beispiel zeigt die Triggerdefinition des Webhooks, für die der Parameter accessKeyType auf Secondary festgelegt ist.

{
  "type": "HttpWebhook",
  "inputs": {
    "subscribe": {
      "method": "POST",
      "uri": "<subscription-URL>",
      "body": "@listCallbackUrl()"
    },
    "accessKeyType": "Secondary"
  },
  "runAfter": {}
}

Verwandte Inhalte

• Zugriff für eingehende Aufrufe anforderungsbasierter Trigger
• Liste aller Logic Apps-Connectors
• Integrierte Connectors in Azure Logic Apps