Freigeben über


Web PubSub-Bindungen für Azure-Funktionen

In diesem Artikel wird erläutert, wie Sie Mithilfe von Azure Web PubSub-Bindungen in Azure Web PubSub Echtzeitnachrichten an Clients senden, die mit Azure Web PubSub-Bindungen in Azure Functions verbunden sind.

Aktion type
Behandeln von Clientereignissen aus Web PubSub Triggerbindung
Behandeln von Clientereignissen aus Web PubSub mit HTTP-Trigger oder Zurückgeben von Clientzugriffs-URL und -Token Eingabebindung
Aufrufen von Dienst-APIs Ausgabebindung

Beispiele

Installieren der Erweiterung

Das NuGet-Erweiterungspaket, das Sie installieren, hängt vom C#-Modus ab, den Sie in Ihrer Funktions-App verwenden:

Funktionen werden in einem isolierten C#-Workerprozess ausgeführt. Weitere Informationen finden Sie im Leitfaden zum Ausführen von Azure Functions (C#) in einem isolierten Workerprozess.

Fügen Sie ihrem Projekt die Erweiterung hinzu, indem Sie dieses NuGet-Paket installieren.

Installieren des Pakets

Die Web PubSub-Erweiterung ist Teil eines Erweiterungsbundles, das in Ihrer host.json Projektdatei angegeben ist. Wenn Sie ein Projekt für Version 3.x oder höher erstellen, sollte dieses Paket bereits installiert sein. Weitere Informationen finden Sie unter Erweiterungspakete.

Hinweis

Die Web PubSub-Erweiterungen für Java werden noch nicht unterstützt.

Wichtige Begriffe

Diagramm: Workflow des Azure Web PubSub-Diensts mit Nutzung von Funktions-Apps.

(1)–(2): WebPubSubConnection-Eingabebindung mit HttpTrigger zum Generieren einer Clientverbindung.

(3)–(4): WebPubSubTrigger-Triggerbindung oder WebPubSubContext-Eingabebindung mit HttpTrigger zum Verarbeiten von Dienstanforderungen.

(5)–(6): WebPubSub-Ausgabebindung zum Anfordern einer Aktion eines Diensts.

Einstellungen für Verbindungszeichenfolgen

Standardmäßig wird eine Namenseinstellung WebPubSubConnectionString der Anwendung verwendet, um Ihre Web PubSub-Verbindungszeichenfolge zu speichern. Wenn Sie einen anderen Einstellungsnamen für Ihre Verbindung verwenden, müssen Sie diesen explizit als Schlüsselnamen in den Bindungsdefinitionen festlegen. Während der lokalen Entwicklung müssen Sie diese Einstellung auch der Sammlung in der Valueslocal.settings.json-Datei hinzufügen.

Wichtig

Eine Verbindungszeichenfolge enthält die Autorisierungsinformationen, die Ihre Anwendung für den Zugriff auf den Azure Web PubSub-Dienst benötigt. Der Zugriffsschlüssel in der Verbindungszeichenfolge ähnelt einem Stammkennwort für Ihren Dienst. Um optimale Sicherheit zu gewährleisten, sollte Ihre Funktions-App verwaltete Identitäten verwenden, wenn Sie eine Verbindung mit dem Web PubSub-Dienst herstellen, anstatt eine Verbindungszeichenfolge zu verwenden. Weitere Informationen finden Sie unter Autorisieren einer verwalteten Identitätsanforderung mithilfe der Microsoft Entra-ID.

Ausführliche Informationen zum Konfigurieren und Verwenden von Web PubSub- und Azure-Funktionen finden Sie im Lernprogramm: Erstellen einer serverlosen Benachrichtigungs-App mit Azure Functions und Azure Web PubSub-Dienst.

Nächste Schritte