Adaptateur SB-Messaging

  • Article

L’adaptateur Service Bus (SB-Messaging) est utilisé pour recevoir et envoyer à partir d’entités Service Bus telles que les files d’attente, les rubriques et les relais. Vous pouvez utiliser l’adaptateur SB-Messaging pour connecter votre BizTalk Server locale à Azure.

À compter de BizTalk Server Feature Pack 2016 2016, Service Bus Premium est pris en charge. Lors de la configuration d’un port d’envoi à l’aide de cet adaptateur, vous pouvez envoyer des messages à des files d’attente et des rubriques partitionnés.

Important

L’adaptateur de SB-Messaging BizTalk utilise le protocole SBMP qui prend en charge les messages jusqu’à une taille maximale de 1 Mo. L’adaptateur BizTalk ne prend pas en charge le protocole AMQP qui peut gérer des messages plus volumineux.

Authentification avec Service Bus

Service Bus fournit deux méthodes pour l’authentification :

  • Service de contrôle d'accès (ACS)
  • Signature d’accès partagé (SAS)

Nous vous recommandons d’utiliser la signature d’accès partagé (SAP) pour l’authentification auprès de Service Bus. La valeur clé d’accès partagé est répertoriée dans le Portail Azure.

Lorsque vous créez un espace de noms Service Bus, l’espace de noms Access Control (ACS) n’est pas créé automatiquement. Pour utiliser Access Control, vous avez besoin des valeurs Nom de l’émetteur et Clé d’émetteur de cet espace de noms. Ces valeurs sont disponibles lorsque vous créez un espace de noms ACS à l’aide de Windows PowerShell. Ces valeurs ne sont pas répertoriées dans le Portail Azure.

Pour utiliser ACS pour l’authentification et obtenir les valeurs de nom et de clé de l’émetteur, les étapes générales sont les suivantes :

  1. Installez les applets de commande Azure PowerShell.

  2. Ajoutez votre compte Azure : Add-AzureAccount

  3. Retournez le nom de votre abonnement : get-azuresubscription

  4. Sélectionnez votre abonnement : select-azuresubscription <name of your subscription>

  5. Créez un espace de noms : new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

    Exemple : new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

  6. Lorsque le nouvel espace de noms ACS est créé (ce qui peut prendre plusieurs minutes), les valeurs IssuerName et IssuerKey sont répertoriées dans le chaîne de connexion :

    Name                  : biztalksbnamespace
Region                : South Central US
DefaultKey            : abcdefghijklmnopqrstuvwxyz
Status                : Active
CreatedAt             : 10/18/2016 9:36:30 PM
AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/
ServiceBusEndpoint    : https://biztalksbnamespace.servicebus.windows.net/
ConnectionString      : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz
NamespaceType         : Messaging

Pour obtenir des conseils, consultez New-AzureSBNamespace .

Recevoir des messages de Service Bus

  1. Dans la console Administration BizTalk Server, développez Groupe BizTalk, Applications, puis développez votre application.

  2. Cliquez avec le bouton droit sur Ports de réception, sélectionnez Nouveau, puis port de réception unidirectionnel.

  3. Donnez-lui un nom, puis sélectionnez Emplacements de réception.

  4. Sélectionnez Nouveau, puis donnez-lui un nom. Dans la section Transport , sélectionnez SB-Messaging dans la liste déroulante Type , puis sélectionnez Configurer.

  5. Configurez les propriétés Général :

    Propriété Pour
    URL de file d’attente ou d’abonnement Spécifier l’URL où la file d’attente Service Bus est déployée. En règle générale, l’URL est au format suivant :

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Délai d’attente d’ouverture Spécifie une valeur de période indiquant le temps nécessaire pour qu’une opération d’ouverture de canal soit réalisée.

    Valeur par défaut : 1 minute
    Délai d’attente de fermeture Spécifie une valeur de période indiquant le temps nécessaire pour qu’une opération de fermeture soit réalisée.

    Valeur par défaut : 1 minute
    Délai d’expiration de réception Spécifie une valeur de période indiquant le temps nécessaire pour qu’une opération de réception soit réalisée.

    Valeur par défaut : 10 minutes
    Nombre de prérécupérations Spécifie le nombre de messages reçus simultanément en provenance de la file d’attente Service Bus ou d’une rubrique. La lecture anticipée permet au client de la file d’attente ou de l’abonnement de charger des messages supplémentaires à partir du service lorsqu’il effectue une opération de réception. Le client stocke ces messages en mémoire cache. La taille du cache est déterminée par la valeur spécifiée ici pour la propriété Nombre de préchargements.

    Pour plus d’informations, reportez-vous à la section « Prérécupération » à l’adresse https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/

    Valeur par défaut : -1
    Utiliser une session Activer cette case à cocher pour utiliser une session Service Bus afin de recevoir des messages en provenance d’une file d’attente ou d’un abonnement.

  6. Configurez les propriétés d’authentification :

    Propriété Pour
    service Access Control Sélectionnez cette option afin d'utiliser ACS pour l'authentification et fournir les valeurs suivantes :

    - Entrez l’URI Service Bus Access Control Service STS. En règle générale, l’URI est au format suivant :

    https://<namespace>-sb.accesscontrol.windows.net/

    - Entrez le nom de l’émetteur pour l’espace de noms Service Bus.

    - Entrez la clé de l’émetteur pour l’espace de noms Service Bus.
    Signature d’accès partagé (nouveauté à partir de BizTalk Server 2013 R2) Sélectionnez cette option pour utiliser la signature d'accès partagé (SAP) pour l'authentification, et fournissez la valeur de clé et le nom de clé SAS.

  7. Sous l’onglet Propriétés, dans l’espace de noms pour les propriétés de message réparti, entrez l’espace de noms que l’adaptateur utilise pour écrire les propriétés de message réparties en tant que propriétés de contexte de message sur le message reçu par BizTalk Server. Si vous souhaitez promouvoir les propriétés de message réparti, sélectionnez la zone Promouvoir les propriétés du message réparti case activée.

  8. Sélectionnez OK.

  9. Sélectionnez votre gestionnaire de réception, puis le pipeline de réception. Sélectionnez OK pour enregistrer vos modifications. Créer un emplacement de réception fournit des conseils.

Envoyer des messages à Service Bus

  1. Dans la console Administration BizTalk Server, cliquez avec le bouton droit sur Envoyer les ports, sélectionnez Nouveau, puis sélectionnez Port d’envoi unidirectionnel statique.

    Créer un port d’envoi fournit des conseils.

  2. Saisissez un Nom. Dans Transport, définissez le Type sur SB-Messaging, puis sélectionnez Configurer.

  3. Configurez les propriétés Général :

    Propriété Pour
    URL de destination Entrez l’URL où la file d’attente Service Bus est déployée. En règle générale, l’URL est au format suivant :

    sb://<namespace>.servicebus.windows.net/<queue_name>
    Intervalle de vidage du lot Spécifie une valeur de période indiquant l’intervalle dans lequel les lots de messages envoyés vers une file d’attente ou une rubrique sont vidés. La valeur par défaut est de 20 millisecondes.

    Pour plus d’informations sur le traitement par lot en ce qui concerne les files d’attente et les rubriques Service Bus, consultez la section traitement par lot côté client à l’adresse https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
    Délai d’attente d’ouverture Spécifie une valeur de période indiquant le temps nécessaire pour qu’une opération d’ouverture de canal soit réalisée.

    Valeur par défaut : 1 minute
    Délai d’attente d’envoi Spécifie une valeur de période indiquant le temps nécessaire pour qu’une opération d’envoi soit réalisée.

    Valeur par défaut : 1 minute
    Délai d’attente de fermeture Spécifie une valeur de période indiquant le temps nécessaire pour qu’une opération de fermeture soit réalisée.

    Valeur par défaut : 1 minute

  4. Configurez les propriétés d’authentification :

    Propriété Pour
    service Access Control Sélectionnez cette option afin d'utiliser ACS pour l'authentification et fournir les valeurs suivantes :

    - Entrez l’URI Service Bus Access Control Service STS. En règle générale, l’URI est au format suivant :

    https://<namespace>-sb.accesscontrol.windows.net/

    - Entrez le nom de l’émetteur pour l’espace de noms Service Bus.

    - Entrez la clé de l’émetteur pour l’espace de noms Service Bus.
    Signature d’accès partagé (nouvelle depuis BizTalk Server 2013 R2) Sélectionnez cette option pour utiliser la signature d'accès partagé (SAP) pour l'authentification, et fournissez la valeur de clé et le nom de clé SAS.

  5. Sous l’onglet Propriétés , entrez l’espace de noms pour les propriétés de message réparti définies par l’utilisateur qui contient les propriétés de contexte de message BizTalk que vous souhaitez écrire sur le message sortant dans Service Bus. Toutes les propriétés d’espace de noms sont écrites dans le message en tant que propriétés de message réparti définies par l’utilisateur. L’adaptateur ignore l’espace de noms lors de l’écriture des propriétés comme propriétés de message réparti. Il utilise l’espace de noms uniquement pour déterminer quelles propriétés écrire.

    Vous pouvez également entrer les valeurs des propriétés BrokeredMessage. Ces propriétés sont décrites dans Propriétés brokeredMessage, y compris la clé de partition.

  6. Sélectionnez OK pour enregistrer vos modifications.

Voir aussi

Utilisation d’adaptateurs