Partager via

Comment envoyer des messages à Azure Service Bus à partir de Gestion des API Azure

S’APPLIQUE À : Développeur | De base | Standard | Prime

Cet article explique comment envoyer des messages de Gestion des API à Azure Service Bus à l’aide de l’intégration basée sur des stratégies. Utilisez Gestion des API pour fournir un moyen sécurisé et évolutif d’envoyer des messages à Service Bus.

Diagramme de l’intégration de Gestion des API à Service Bus pour la messagerie.

Azure Service Bus est un service de messagerie d’entreprise entièrement géré conçu pour dissocier les applications et les services, ce qui permet une messagerie cloud fiable entre les systèmes distribués. Il prend en charge AMQP (Advanced Message Queuing Protocol) pour que les systèmes envoient des messages à des files d’attente de messages pour des communications un-à-un et à des sujets pour les modèles de publication/abonnement. Service Bus est idéal pour les scénarios nécessitant des opérations asynchrones, un nivellement de charge ou une intégration dans des environnements cloud hybrides. Pour plus d’informations, consultez la documentation Azure Service Bus.

Avec l’intégration basée sur des stratégies, Gestion des API fournit les éléments suivants :

  • Messagerie REST sécurisée pour les clients externes : les systèmes externes et les applications mobiles qui ne prennent pas en charge AMQP natif peuvent envoyer des messages à Service Bus à l’aide d’API HTTP/REST standard via Gestion des API. Cette approche simplifie l’intégration et améliore la sécurité en éliminant le besoin d’intermédiaires personnalisés.
  • Intégrations tierces régies : les entreprises peuvent exposer des points de terminaison Service Bus via Gestion des API avec l’authentification d’identité managée intégrée, ce qui permet des modèles de messagerie sécurisés et observables pour les partenaires et les applications tierces.
  • Déclencher et oublier le modèle : aucun autre service back-end n’est nécessaire pour envoyer des messages à Service Bus, ce qui simplifie les architectures et réduit la surcharge opérationnelle.

Note

  • L’intégration de gestion des API à Service Bus est actuellement en préversion.
  • Seul l’envoi de messages à Service Bus est pris en charge.

Note

Actuellement, cette fonctionnalité n’est pas disponible dans les espaces de travail.

Prerequisites

  • Instance de service Gestion des API. Si vous n’en avez pas, consultez Créer une instance de service Gestion des API.

  • API de gestion des API utilisée pour envoyer des messages à Service Bus.

  • File d’attente ou rubrique dans un espace de noms Azure Service Bus pour recevoir des messages. Pour obtenir des instructions détaillées, consultez l’une des rubriques suivantes :

    Note

    • Si vous souhaitez utiliser des rubriques et des abonnements, choisissez le niveau Service Bus Standard ou Premium.
    • La ressource Service Bus peut se trouver dans un autre abonnement ou même dans un autre locataire que la ressource Gestion des API.

  • Autorisations d’attribution de rôles à une identité managée.

Configurer l’accès au service bus

Pour envoyer des messages au service bus, vous devez configurer une identité managée pour votre instance Gestion des API :

  1. Activez une identité managée affectée par le système ou affectée par l’utilisateur pour Gestion des API dans votre instance Gestion des API.

    • Si vous activez une identité gérée assignée par l'utilisateur, prenez note de l’ID client de l’identité.

  2. Attribuez l’identité au rôle Expéditeur de données Azure Service Bus, au niveau du bus de services. Pour attribuer le rôle, utilisez le portail Azure ou d’autres outils Azure.

Configurer la politique send-service-bus-message

Configurez la stratégie send-service-bus-message pour envoyer des messages à la file d’attente ou au sujet souhaité.

Par exemple, utilisez la send-service-bus-message stratégie dans la section de stratégie de trafic entrant pour envoyer le corps de la requête d’une requête d’API lorsque la passerelle la reçoit :

  1. Dans le portail Azure, accédez à votre instance Gestion des API.

  2. Dans le menu de gauche, sélectionnez LES API, puis sélectionnez l’API dans laquelle vous souhaitez ajouter la stratégie.

  3. Sélectionnez Toutes les opérations.

  4. En haut de l’écran, sélectionnez l’onglet Création .

  5. Dans la fenêtre de traitement entrant ou de traitement sortant , sélectionnez l’icône </> (éditeur de code). Pour plus d’informations, consultez Comment définir ou modifier des stratégies.

  6. Placez votre curseur dans la section des stratégies inbound ou outbound.

  7. Ajoutez la send-service-bus-message stratégie à la configuration de la stratégie, puis configurez les attributs et les éléments en fonction des besoins.

    Par exemple, envoyez le corps de la demande en tant que message :

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

    Vous pouvez utiliser n’importe quelle expression qui retourne une chaîne comme valeur pour l’élément payload .

  8. Sélectionnez Enregistrer pour enregistrer la configuration de stratégie mise à jour. Dès que vous l’enregistrez, la stratégie devient active et les messages sont envoyés au bus de service désigné.

Contenu connexe

  • Last updated on