Odesílání zpráv do služby Azure Service Bus ze služby Azure API Management

PLATÍ PRO: Vývojář | Základní | Standardní | Prémiový

Tento článek popisuje, jak odesílat zprávy ze služby API Management do služby Azure Service Bus pomocí integrace založené na zásadách. Pomocí služby API Management můžete poskytovat zabezpečený a škálovatelný způsob odesílání zpráv do služby Service Bus.

Azure Service Bus je plně spravovaná podniková služba zasílání zpráv navržená k oddělení aplikací a služeb, což umožňuje spolehlivé cloudové zasílání zpráv mezi distribuovanými systémy. Podporuje protokol AMQP (Advanced Message Queuing Protocol) pro systémy, které odesílají zprávy do front zpráv pro komunikaci 1:1 a témata pro vzory publikování a odběru. Service Bus je ideální pro scénáře vyžadující asynchronní operace, vyrovnávání zatížení nebo integraci napříč hybridními cloudovými prostředími. Další informace najdete v dokumentaci ke službě Azure Service Bus.

S integrací založenou na zásadách poskytuje služba API Management:

• Zabezpečené zasílání zpráv založené na REST pro externí klienty – externí systémy a mobilní aplikace, které nemají nativní podporu AMQP, můžou odesílat zprávy do služby Service Bus pomocí standardních rozhraní HTTP/REST API prostřednictvím služby API Management. Tento přístup zjednodušuje integraci a zvyšuje zabezpečení tím, že eliminuje potřebu vlastních zprostředkovatelů.
• Řízené integrace třetích stran – Podniky můžou prostřednictvím služby API Management vystavit koncové body služby Service Bus s integrovaným ověřováním spravovaných identit, což umožňuje zabezpečené a pozorovatelné vzory zasílání zpráv pro partnery a aplikace třetích stran.
• Model aktivujte a zapomeňte – k odesílání zpráv do služby Service Bus nejsou potřeba žádné jiné back-endové služby, což umožňuje jednodušší architekturu a nižší provozní režii.

Poznámka:

• Integrace služby API Management se službou Service Bus je aktuálně ve verzi Preview.
• Podporuje se jenom odesílání zpráv do služby Service Bus.

Poznámka:

V současné době tato funkce není dostupná v pracovních prostorech.

Požadavky

• Instance služby API Management. Pokud ho nemáte, přečtěte si téma Vytvoření instance služby API Management.

• Rozhraní API pro správu sloužící k odesílání zpráv do služby Service Bus.

• Fronta nebo témat v namespace služby Azure Service Bus pro příjem zpráv Podrobný postup najdete v následujících tématech:

  • Vytvoření oboru názvů a fronty služby Service Bus
  • Vytvořte téma služby Service Bus a odběry k tomuto tématu

  Poznámka:

  • Pokud chcete použít témata a předplatná, zvolte úroveň Service Bus Standard nebo Premium.
  • Prostředek služby Service Bus může být v jiném předplatném nebo dokonce u jiného tenanta než prostředek služby API Management.

• Oprávnění k přiřazování rolí spravované identitě

Konfigurace přístupu ke službě Service Bus

Pokud chcete odesílat zprávy do služby Service Bus, musíte pro instanci služby API Management nakonfigurovat spravovanou identitu:

1. Povolte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem pro službu API Management ve vaší instanci služby API Management.

   • Pokud povolíte uživatelsky přiřazenou spravovanou identitu, poznamenejte si její ID klienta.

2. Přiřaďte identitu roli odesílatele dat služby Azure Service Bus s vymezeným oborem služby Service Bus. K přiřazení role použijte Azure Portal nebo jiné nástroje Azure.

Nakonfigurujte zásady pro odesílání zpráv pomocí service-bus

Nakonfigurujte zásadu odesílání zpráv service-bus-message tak, aby odesílala zprávy do požadované fronty nebo tématu.

Například použijte zásadu send-service-bus-message v části příchozí zásady k odeslání textu těla žádosti rozhraní API, když brána žádost přijme.

1. Na webu Azure Portal přejděte do vaší instance služby API Management.

2. V nabídce vlevo vyberte rozhraní API a pak vyberte rozhraní API, do kterého chcete zásadu přidat.

3. Vyberte Všechny operace.

4. V horní části obrazovky vyberte kartu Návrh .

5. V okně Zpracování příchozích dat nebo Odchozí zpracování vyberte </> ikonu (editor kódu). Další informace naleznete v tématu Jak nastavit nebo upravit zásady.

6. Umístěte kurzor do oddílu inbound nebo outbound zásad.

7. Přidejte zásadu send-service-bus-message do konfigurace zásad a podle potřeby nakonfigurujte atributy a prvky.

   Například odešlete text požadavku jako zprávu:

   <send-service-bus-message queue-name="my-queue">
       <payload>@(context.Request.Body.As<string>())</payload>
   </send-service-bus-message>
   

   Můžete použít libovolný výraz, který vrací řetězec jako hodnotu prvku payload .

8. Výběrem možnosti Uložit uložte aktualizovanou konfiguraci zásad. Jakmile ji uložíte, zásada je aktivní a zprávy se posílají do určené služby Service Bus.

Související obsah

• Používání externích služeb
• zásady pro odesílání zpráv service-bus