Skicka klienthändelser till Event Hubs

Översikt

Om du vill lyssna på dina klienthändelser utan att exponera en offentligt tillgänglig slutpunkt kan du konfigurera en "händelselyssnare"-regel med en händelsehubbslutpunkt och ett filter för att ange vilka typer av händelser det gäller. Du kan konfigurera flera händelselyssnare samtidigt. Web PubSub-tjänsten meddelar alla berörda händelselyssnare parallellt när en klienthändelse inträffar.

Den här självstudien visar hur du auktoriserar din Web PubSub-tjänst för att ansluta till Event Hubs och hur du lägger till en regel för händelselyssnare i dina tjänstinställningar.

Web PubSub-tjänsten använder Microsoft Entra-ID med hanterad identitet för att ansluta till Event Hubs. Därför bör du aktivera tjänstens hanterade identitet och se till att den har rätt behörighet att ansluta till Event Hubs. Du kan tilldela den hanterade identiteten den inbyggda Azure Event Hubs Data Sender-rollen så att den får tillräckliga behörigheter.

För att konfigurera en Event Hubs-lyssnare måste du:

Konfigurera en händelselyssnare

Lägga till en hanterad identitet i din Web PubSub-tjänst

Hitta din Azure Web PubSub-tjänst från Azure Portal. Gå till Identitet. Om du vill lägga till en systemtilldelad identitet går du till fliken Systemtilldelad och växlar Status till . Välj Spara. Mer information om hanterade identiteter finns i Hanterade identiteter i Azure Web PubSub.

Skärmbild av att lägga till en systemtilldelad identitet i portalen

Tilldela den hanterade identiteten en Azure Event Hubs Data sender roll

  1. Hitta din Azure Event Hubs-resurs i Azure Portal. Du kan välja att bevilja rollen på Event Hubs-namnområdesnivå eller entitetsnivå. Följande steg väljer namnområdesnivå.

  2. Gå till Åtkomstkontroll. Välj Lägg till rolltilldelning. Skärmbild av att bevilja åtkomst till Event Hubs-namnområdet

  3. Välj rollen Azure Event Hubs Data Sender på fliken Roll . Välj sedan Nästa. Skärmbild av hur du väljer rollen Azure EventHubs Data Sender

  4. På fliken Medlemmar väljer du att tilldela åtkomst till hanterad identitet. Välj Välj medlemmar för att välja din Web PubSub-tjänst. Sedan kan du granska och tilldela rolltilldelningen. Skärmbild av hur du väljer din webb-PubSub-tjänstidentitet

Lägga till en regel för händelselyssnare i tjänstinställningarna

  1. Hitta din tjänst från Azure Portal. Gå till Inställningar. Välj sedan Lägg till för att konfigurera händelselyssnaren. För en befintlig hubbkonfiguration navigerar du till samma redigeringssida genom att välja ... på höger sida. Skärmbild av Web PubSub-inställningar

  2. På redigeringssidan nedan behöver du konfigurera hubbnamnet och välja Lägg till för att lägga till en händelselyssnare. Skärmbild av konfiguration av hubbinställningar

  3. På sidan Konfigurera händelselyssnare konfigurerar du först en händelsehubbslutpunkt. Du kan välja Välj händelsehubb från din prenumeration för att välja, eller direkt ange det fullständigt kvalificerade namnområdet och händelsehubbens namn. Välj sedan de user- och system-händelser du vill lyssna på. Välj slutligen Bekräfta när allt är klart. Skärmbild av konfiguration av Event Hubs-lyssnare

Testa konfigurationen med en livedemo

  1. Öppna den här Event Hubs Consumer Client-webbappen och ange anslutningssträngen för Event Hubs för att ansluta till en händelsehubb som en konsument. Om du får Event Hubs-anslutningssträng från en Event Hubs-namnområdesresurs i stället för en händelsehubbinstans måste du ange händelsehubbens namn. Den här händelsehubbens konsumentklient är ansluten till läget som bara läser nya händelser. händelserna som publicerats tidigare visas inte här. Du kan ändra anslutningsläget för konsumentklienten för att läsa alla tillgängliga händelser i produktionsmiljön.

  2. Använd webbappen WebSocket Client för att generera klienthändelser. Om du har konfigurerat för att skicka systemhändelsen connected till den händelsehubben bör du kunna se en tryckt connected händelse i Event Hubs-konsumentklienten när du har anslutit till Web PubSub-tjänsten. Du kan också generera en användarhändelse med appen. Skärmbild av en utskriven ansluten händelse i händelsehubbens konsumentklientapp. Skärmbild som visar området för WebSocket-klientappen för att generera en användarhändelse.

Nästa steg

I den här artikeln har du lärt dig hur händelselyssnare fungerar och hur du konfigurerar en händelselyssnare med en händelsehubbslutpunkt. Läs följande specifikation om du vill veta vilket dataformat som skickas till Event Hubs.