SB-Messaging Adapter

Der Service Bus-Adapter (SB-Messaging) wird verwendet, um Nachrichten von Service Bus-Entitäten wie Warteschlangen, Themen und Relays zu empfangen und zu senden. Sie können den SB-Messaging-Adapter verwenden, um Ihren lokalen BizTalk Server mit Azure zu verbinden.

Ab BizTalk Server 2016 Feature Pack 2 wird Service Bus Premium unterstützt. Beim Konfigurieren eines Sendeports mithilfe dieses Adapters können Sie Nachrichten an partitionierte Warteschlangen und Themen senden.

Authentifizieren mit ServiceBus

Service Bus bietet zwei Methoden für die Authentifizierung:

• Zugriffssteuerungsdienst (Access Control Service, ACS)
• Signatur für gemeinsam genutzten Zugriff (Shared Access Signature, SAS)

Es wird empfohlen, die Gemeinsame Zugriffssignatur (Shared Access Signature, SAS) zur Authentifizierung mit Service Bus zu verwenden. Der Wert "Shared Access Key" wird im Azure-Portal aufgeführt.

Wenn Sie einen Service Bus-Namespace erstellen, wird der Access Control (ACS)-Namespace nicht automatisch erstellt. Um die Zugriffssteuerung zu verwenden, benötigen Sie die Ausstellernamen- und Ausstellerschlüsselwerte dieses Namespaces. Diese Werte sind verfügbar, wenn Sie einen neuen ACS-Namespace mit Windows PowerShell erstellen. Diese Werte werden nicht im Azure-Portal aufgeführt.

Um ACS für die Authentifizierung zu verwenden und die Werte des Ausstellernamens und des Ausstellerschlüssels abzurufen, umfassen die folgenden allgemeinen Schritte:

1. Installieren Sie die Azure Powershell-Cmdlets.

2. Hinzufügen Ihres Azure-Kontos: Add-AzureAccount

3. Geben Sie Ihren Abonnementnamen zurück: get-azuresubscription

4. Wählen Sie Ihr Abonnement aus: select-azuresubscription <name of your subscription>

5. Erstellen Sie einen neuen Namespace: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

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

6. Wenn der neue ACS-Namespace erstellt wird (der mehrere Minuten dauern kann), werden die IssuerName- und IssuerKey-Werte in der Verbindungszeichenfolge aufgeführt:

   Vorsicht

   In diesem Beispiel oder Leitfaden wird auf vertrauliche Informationen verwiesen, z. B. auf eine Verbindungszeichenfolge oder einen Benutzernamen und ein Kennwort. Codieren Sie diese Werte niemals in Ihrem Code, und stellen Sie sicher, dass Sie vertrauliche Daten mithilfe der sichersten verfügbaren Authentifizierung schützen. Weitere Informationen finden Sie in der folgenden Dokumentation:

   • Sicherheit in BizTalk Server
   • Sicherheit für das Senden und Empfangen von Nachrichten
   • Zugriffssteuerung und Datensicherheit

   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
   

Anleitungen finden Sie unter "New-AzureSBNamespace" .

Empfangen von Nachrichten von Service Bus

1. Erweitern Sie in der BizTalk Server-Verwaltungskonsole die BizTalk-Gruppe, erweitern Sie Anwendungen, und erweitern Sie dann Ihre Anwendung.

2. Klicken Sie mit der rechten Maustaste auf "Empfangsport", wählen Sie " Neu" aus, und wählen Sie One-Way Empfangsport aus.

3. Geben Sie ihm einen Namen und wählen Sie Empfangsstandorte aus.

4. Wählen Sie "Neu" aus, geben Sie ihm einen Namen. Wählen Sie im Abschnitt "Transport " sb-Messaging aus der Dropdownliste " Typ " und dann " Konfigurieren" aus.

5. Konfigurieren sie die allgemeinen Eigenschaften:

   Verwenden Sie diese	Aktion
   Warteschlangen- oder Abonnement-URL	Geben Sie die URL an, unter der die Servicebus-Warteschlange bereitgestellt wird. In der Regel weist die URL das folgende Format auf: sb://<namespace>.servicebus.windows.net/<queue_name>
   Timeout öffnen	Gibt einen Zeitspannwert an, der die Zeit für den Abschluss eines Kanalöffnungsvorgangs angibt. Standardwert: 1 Minute
   Timeout schließen	Gibt einen Zeitspannwert an, der die Zeit für den Abschluss eines Kanalschließvorgangs angibt. Standardwert: 1 Minute
   Timeout empfangen	Gibt einen Zeitspannwert an, der die Zeit für den Abschluss eines Empfangsvorgangs angibt. Standardwert: 10 Minuten
   Anzahl der Vorabrufe	Gibt die Anzahl der Nachrichten an, die gleichzeitig von der Service Bus-Warteschlange oder einem Topic empfangen werden. Beim Vorabrufen kann der Warteschlangen- oder Abonnementclient zusätzliche Nachrichten aus dem Dienst laden, wenn er einen Empfangsvorgang ausführt. Der Client speichert diese Nachrichten in einem lokalen Cache. Die Größe des Caches wird durch den Wert für die Prefetch Count-Eigenschaft bestimmt, die Sie hier angeben. Weitere Informationen finden Sie im Abschnitt "Prefetching" unter https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/ Standardwert: -1
   Session nutzen	Aktivieren Sie dieses Kontrollkästchen, um eine Service Bus-Sitzung zum Empfangen von Nachrichten aus einer Warteschlange oder einem Abonnement zu verwenden.

6. Konfigurieren sie die Authentifizierungseigenschaften :

   Verwenden Sie diese	Aktion
   Zugriffssteuerungsdienst	Wählen Sie diese Option aus, um ACS für die Authentifizierung zu verwenden, und geben Sie die folgenden Werte an: - Geben Sie den Service Bus-Zugriffssteuerungsdienst-STS-URI ein. In der Regel weist der URI das folgende Format auf: https://<namespace>-sb.accesscontrol.windows.net/ - Geben Sie den Ausstellernamen für den Service Bus-Namespace ein. - Geben Sie den Ausstellerschlüssel für den Service Bus-Namespace ein.
   Signatur für freigegebenen Zugriff (neu ab BizTalk Server 2013 R2)	Wählen Sie diese Option aus, um die Shared Access Signature (SAS) für die Authentifizierung zu verwenden, und geben Sie den SAS-Schlüsselnamen und den Schlüsselwert an.

7. Geben Sie auf der Registerkarte "Eigenschaften " im Namespace für "Brokered Message Properties" den Namespace ein, den der Adapter zum Schreiben der brokerierten Nachrichteneigenschaften als Nachrichtenkontexteigenschaften für die von BizTalk Server empfangene Nachricht verwendet. Wenn Sie die vermittelten Nachrichteneigenschaften hervorheben möchten, aktivieren Sie das Kontrollkästchen "Vermittelte Nachrichteneigenschaften hervorheben".

8. Wählen Sie OK aus.

9. Wählen Sie ihren Empfangshandler und die Empfangspipeline aus. Klicken Sie auf OK, um die Änderungen zu speichern. Erstellen eines Empfangsorts bietet einige Hinweise.

Senden von Nachrichten an Service Bus

1. Klicken Sie in der BizTalk Server-Verwaltungskonsole mit der rechten Maustaste auf "Ports senden", wählen Sie "Neu" aus, und wählen Sie "Statischer Unidirektionale Sendeport" aus.

   Das Erstellen eines Sendeports enthält einige Anleitungen.

2. Geben Sie einen Namen ein. Legen Sie im Transport den Typ auf SB-Messaging fest, und wählen Sie "Konfigurieren" aus.

3. Konfigurieren sie die allgemeinen Eigenschaften:

   Verwenden Sie diese	Aktion
   Ziel-URL	Geben Sie die URL ein, unter der die Servicebus-Warteschlange bereitgestellt wird. In der Regel weist die URL das folgende Format auf: sb://<namespace>.servicebus.windows.net/<queue_name>
   Batch-Leerungsintervall	Gibt einen Zeitspannwert an, der das Intervall angibt, wenn die Nachrichtenbatches an eine Warteschlange oder ein Thema gesendet werden. Der Standardwert sind 20 Millisekunden. Weitere Informationen zum Batching in Bezug auf Service Bus Queues und Topics finden Sie im Abschnitt "Clientseitige Batchverarbeitung" unter https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
   Timeout öffnen	Gibt einen Zeitspannwert an, der die Zeit für den Abschluss eines Kanalöffnungsvorgangs angibt. Standardwert: 1 Minute
   Timeout senden	Gibt einen Zeitspannwert an, der die Zeit für den Abschluss eines Sendevorgangs angibt. Standardwert: 1 Minute
   Timeout schließen	Gibt einen Zeitspannwert an, der die Zeit für den Abschluss eines Kanalschließvorgangs angibt. Standardwert: 1 Minute

4. Konfigurieren sie die Authentifizierungseigenschaften :

   Verwenden Sie diese	Aktion
   Zugriffssteuerungsdienst	Wählen Sie diese Option aus, um ACS für die Authentifizierung zu verwenden, und geben Sie die folgenden Werte an: - Geben Sie den Service Bus-Zugriffssteuerungsdienst-STS-URI ein. In der Regel weist der URI das folgende Format auf: https://<namespace>-sb.accesscontrol.windows.net/ - Geben Sie den Ausstellernamen für den Service Bus-Namespace ein. - Geben Sie den Ausstellerschlüssel für den Service Bus-Namespace ein.
   Signatur für freigegebenen Zugriff (neu ab BizTalk Server 2013 R2)	Wählen Sie diese Option aus, um die Shared Access Signature (SAS) für die Authentifizierung zu verwenden, und geben Sie den SAS-Schlüsselnamen und den Schlüsselwert an.

5. Geben Sie auf der Registerkarte "Eigenschaften " den Namespace für die benutzerdefinierten Brokered Message-Eigenschaften ein, die die BizTalk-Nachrichtenkontexteigenschaften enthalten, die Sie in die ausgehende Nachricht in Service Bus schreiben möchten. Alle Namespaceeigenschaften werden als benutzerdefinierte Brokered Message-Eigenschaften in die Nachricht geschrieben. Der Adapter ignoriert beim Schreiben der Eigenschaften den Namespace und behandelt sie als Brokered Message-Eigenschaften. Er verwendet den Namespace nur, um zu ermitteln, welche Eigenschaften geschrieben werden sollen.

   Sie können auch die Werte für die BrokeredMessage-Eigenschaften eingeben. Diese Eigenschaften werden unter BrokeredMessage-Eigenschaften beschrieben, einschließlich des Partitionsschlüssels.

6. Klicken Sie auf OK, um die Änderungen zu speichern.

Siehe auch

Verwenden von Adaptern