Berichten verzenden naar Azure Service Bus vanuit Azure API Management

VAN TOEPASSING OP: Ontwikkelaar | Basic | Standaard | Premie

In dit artikel wordt beschreven hoe u berichten verzendt van API Management naar Azure Service Bus met behulp van integratie op basis van beleid. Gebruik API Management om een veilige en schaalbare manier te bieden om berichten naar Service Bus te verzenden.

Azure Service Bus is een volledig beheerde bedrijfsberichtenservice die is ontworpen om toepassingen en services los te koppelen, waardoor betrouwbare cloudberichten tussen gedistribueerde systemen mogelijk zijn. Het ondersteunt AMQP (Advanced Message Queuing Protocol) voor systemen voor het verzenden van berichten naar berichtenwachtrijen voor één-op-één-communicatie en onderwerpen voor het publiceren/abonneren van patronen. Service Bus is ideaal voor scenario's waarvoor asynchrone bewerkingen, load leveling of integratie in hybride cloudomgevingen zijn vereist. Zie de Documentatie van Azure Service Bus voor meer informatie.

Met integratie op basis van beleid biedt API Management het volgende:

• Beveiligde OP REST gebaseerde berichten voor externe clients : externe systemen en mobiele apps die geen systeemeigen AMQP-ondersteuning hebben, kunnen berichten verzenden naar Service Bus met behulp van standaard HTTP/REST API's via API Management. Deze aanpak vereenvoudigt de integratie en verbetert de beveiliging door de noodzaak van aangepaste tussenpersonen te elimineren.
• Beheerde integraties van derden : ondernemingen kunnen Service Bus-eindpunten beschikbaar maken via API Management met ingebouwde verificatie van beheerde identiteiten, waardoor veilige en waarneembare berichtpatronen voor partners en toepassingen van derden mogelijk zijn.
• Fire and forget model : er zijn geen andere back-endservices vereist om berichten naar Service Bus te verzenden, waardoor eenvoudigere architecturen en minder operationele overhead mogelijk zijn.

Vereiste voorwaarden

• Een API Management-service-exemplaar. Zie Een API Management-service-exemplaar maken als u er nog geen hebt.

• Een API Management-API die wordt gebruikt voor het verzenden van berichten naar Service Bus.

• Een wachtrij of onderwerp in een Azure Service Bus-naamruimte om berichten te ontvangen. Zie een van de volgende stappen voor gedetailleerde stappen:

  • Een Service Bus-naamruimte en -wachtrij maken
  • Een Service Bus-onderwerp en -abonnementen voor het onderwerp maken

  Opmerking

  • Als u onderwerpen en abonnementen wilt gebruiken, kiest u de Service Bus Standard- of Premium-laag.
  • De Service Bus-resource kan zich in een ander abonnement bevinden of zelfs een andere tenant dan de API Management-resource.

• Machtigingen voor het toewijzen van rollen aan een beheerde identiteit.

Toegang tot de servicebus configureren

Als u berichten naar de servicebus wilt verzenden, moet u een beheerde identiteit configureren voor uw API Management-exemplaar:

1. Schakel een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit in voor API Management in uw API Management-exemplaar.

   • Als u een door de gebruiker toegewezen beheerde identiteit inschakelt, noteert u de client-id van de identiteit.

2. Wijs de identiteit toe aan de rol Azure Service Bus-gegevenszender , binnen het bereik van de servicebus. Als u de rol wilt toewijzen, gebruikt u Azure Portal of andere Azure-hulpprogramma's.

Configureer het beleid voor het verzenden van service-bus-berichten

Configureer het beleid send-service-bus-message om berichten naar de gewenste wachtrij of het gewenste onderwerp te verzenden.

Gebruik bijvoorbeeld het send-service-bus-message beleid in de sectie binnenkomend beleid om de aanvraagbody van een API-aanvraag te verzenden wanneer de gateway deze ontvangt:

1. Ga in Azure Portal naar uw API Management-exemplaar.

2. Selecteer API's in het linkermenu en selecteer vervolgens de API waaraan u het beleid wilt toevoegen.

3. Selecteer Alle bewerkingen.

4. Selecteer boven aan het scherm het tabblad Ontwerpen .

5. Selecteer in het venster Voor binnenkomende verwerking of uitgaande verwerking het </> pictogram (code-editor). Zie Beleidsregels instellen of bewerken voor meer informatie.

6. Plaats de cursor in de inbound sectie of outbound het beleid.

7. Voeg het send-service-bus-message beleid toe aan de beleidsconfiguratie en configureer zo nodig de kenmerken en elementen.

   Verzend bijvoorbeeld de hoofdtekst van de aanvraag als een bericht:

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

   U kunt elke expressie gebruiken die een tekenreeks retourneert als de waarde voor het payload element.

8. Selecteer Opslaan om de bijgewerkte beleidsconfiguratie op te slaan. Zodra u het opslaat, is het beleid actief en worden berichten verzonden naar de aangewezen servicebus.

Verwante inhoud

• Externe services gebruiken
• beleid voor het verzenden van servicebusberichten