WCF-BasicHttpRelay-Adapter

Artikel
07/21/2023

Microsoft BizTalk Server verwendet den WCF-BasicHttpRelay-Adapter zum Empfangen und Senden von WCF-Dienstanforderungen über die BasicHttpRelayBinding-Klasse. Der WCF-BasicHttpRelay-Adapter verwendet Service Bus-Relayendpunkte mithilfe von BasicHttpRelayBinding.

Voraussetzungen

Ab BizTalk Server 2016 kann dieser Adapter Access Control Service (ACS) oder die Shared Access Signature (SAS) verwenden, um mit Service Bus zu athenticate. Es wird empfohlen, bei der Authentifizierung mit Service Bus die SAS (Shared Access Signature) zu verwenden.

Wenn Sie einen Service Bus-Namespace erstellen, wird der Access Control-Namespace (ACS) nicht automatisch erstellt. Wenn Sie ACS zur Authentifizierung verwenden, müssen Sie möglicherweise einen neuen ACS-Namespace erstellen. Ausführlichere Informationen finden Sie unter SB-Messaging-Adapter , einschließlich der Schritte zum Abrufen der ACS-Schlüsselwerte.

Erstellen des Empfangsspeicherorts

Hinweis

Bevor Sie das folgende Verfahren ausführen, müssen Sie bereits einen unidirektionalen Empfangsport hinzugefügt haben. Weitere Informationen finden Sie unter Erstellen eines Empfangsports.

Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server-Verwaltung, BizTalk-Gruppe, Anwendungen, und erweitern Sie dann die Anwendung, unter der Sie einen Empfangsspeicherort erstellen möchten.
Klicken Sie im linken Bereich auf den Knoten Empfangsports , und klicken Sie dann im rechten Bereich mit der rechten Maustaste auf den Empfangsport, der dem neuen Empfangsspeicherort zugeordnet werden soll. Klicken Sie dann auf Eigenschaften.
Wählen Sie im linken Bereich des Dialogfelds Eigenschaften für Empfangsport die Option Empfangsspeicherorteaus, und klicken Sie dann im rechten Bereich auf Neu , um einen neuen Empfangsspeicherort zu erstellen.
Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Abschnitt Transport die Option WCF-BasicHttpRelay aus der Dropdownliste Typ aus, und klicken Sie dann auf Konfigurieren , um die Transporteigenschaften für den Empfangsspeicherort zu konfigurieren.

Konfigurieren Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Allgemein die Endpunktadresse, an der der Service Bus-Relayendpunkt gehostet wird, und die Dienstidentität für den WCF-BasicHttpRelay Empfangsspeicherort.

Option	Aufgabe
Adresse (URI)	Erforderlich. Geben Sie den URI an, an dem der Service Bus-Relayendpunkt bereitgestellt wird.
Endpunktidentität	Optional. Gibt die Endpunktidentität an. Diese Einstellungen ermöglichen dem Endpunkt die Authentifizierung dieses Empfangsspeicherorts. Während des Handshakevorgangs zwischen dem Endpunkt und dem Empfangsspeicherort wird durch die Windows Communication Foundation-Infrastruktur (WCF) sichergestellt, dass die Identität des erwarteten Diensts mit den Werten dieses Elements übereinstimmt. Der Standardwert ist eine leere Zeichenfolge.

Option

Aufgabe

Adresse (URI)

Erforderlich. Geben Sie den URI an, an dem der Service Bus-Relayendpunkt bereitgestellt wird.

Endpunktidentität

Optional. Gibt die Endpunktidentität an. Diese Einstellungen ermöglichen dem Endpunkt die Authentifizierung dieses Empfangsspeicherorts. Während des Handshakevorgangs zwischen dem Endpunkt und dem Empfangsspeicherort wird durch die Windows Communication Foundation-Infrastruktur (WCF) sichergestellt, dass die Identität des erwarteten Diensts mit den Werten dieses Elements übereinstimmt.

Der Standardwert ist eine leere Zeichenfolge.

Konfigurieren Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Bindung die Timeout- und Codierungseigenschaften.

Option	Aufgabe
Timeout des Öffnungsvorgangs (hh:mm:ss)	Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht. Dieser Wert sollte größer oder gleich System.TimeSpan.Zerosein. Standardwert: 00:01:00 Maximalwert: 23:59:59
Timeout des Sendevorgangs (hh:mm:ss)	Legt einen Wert für den Zeitraum fest, der bis zum Abschluss eines Sendevorgangs zur Verfügung steht. Dieser Wert sollte größer oder gleich System.TimeSpan.Zerosein. Wenn Sie einen Empfangsport vom Typ "Anforderungsantwort" verwenden, gibt dieser Wert den Zeitraum an, in dem die gesamte Interaktion auch dann abgeschlossen sein muss, wenn vom Client eine umfangreiche Nachricht zurückgegeben wird. Standardwert: 00:01:00 Maximalwert: 23:59:59
Timeout des Schließvorgangs (hh:mm:ss)	Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht. Dieser Wert sollte größer oder gleich System.TimeSpan.Zerosein. Standardwert: 00:01:00 Maximalwert: 23:59:59
Maximalgröße empfangener Nachrichten (Byte)	Gibt die Maximalgröße in Bytes für Nachrichten einschließlich der Header an, die über das Netzwerk empfangen werden können. Die Nachrichtengröße wird durch den für jede Nachricht reservierten Arbeitsspeicher begrenzt. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken. Der WCF-BasicHttpRelay-Adapter nutzt die BasicHttpRelayBinding-Klasse im gepufferten Übertragungsmodus, um mit einem Endpunkt zu kommunizieren. Für den gepufferten Transportmodus ist die BasicHttpRelayBinding.MaxBufferSize-Eigenschaft immer gleich dem Wert dieser Eigenschaft. Standardwert: 65536 Maximalwert: 2147483647
Nachrichtencodierung	Hier geben Sie den Encoder an, der zum Codieren der SOAP-Nachricht verwendet werden soll. Gültige Werte sind: - Text: Verwenden Sie einen Textnachrichtenencoder. - Mtom: Verwenden Sie einen MTOM-Encoder (Message Transmission Organization Mechanism 1.0). Der Standardwert ist Text.
Textcodierung	Geben Sie die Zeichensatzcodierung an, die zum Senden von Nachrichten in der Bindung verwendet werden soll, wenn die Eigenschaft Message-Codierung auf Text festgelegt ist. Gültige Werte sind: - utf-16BE (unicodeFFFE): Unicode BigEndian-Codierung. - utf-16: 16-Bit-Codierung. - utf-8: 8-Bit-Codierung Der Standardwert ist utf-8.
Maximale Anzahl gleichzeitiger Aufrufe	Gibt die Anzahl gleichzeitiger Aufrufe für eine einzelne Dienstinstanz an. Aufrufe, die diese Grenze überschreiten, werden in die Warteschlange eingereiht. Das Festlegen dieses Werts auf 0 entspricht dem Festlegen auf Int32.MaxValue. Standardwert: 200.

Definieren Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Sicherheit die Sicherheitsfunktionen des WCF-BasicHttpRelay Empfangsspeicherorts.

Option	Aufgabe
Sicherheitsmodus	Gibt den verwendeten Sicherheitstyp an. Gültige Werte sind: - Keine: Nachrichten werden während der Übertragung nicht gesichert. - Transport: Die Sicherheit wird mithilfe des HTTPS-Transports bereitgestellt. Die SOAP-Nachrichten werden bei der Verwendung von HTTPS gesichert. Um diesen Modus zu verwenden, muss SSL (Secure Sockets Layer) in den Microsoft Internetinformationsdiensten (IIS) eingerichtet sein. - Nachricht: Die Sicherheit wird mithilfe der SOAP-Nachrichtensicherheit über den HTTP-Transport bereitgestellt. Standardmäßig ist der SOAP-Text verschlüsselt und signiert. Der einzige gültige Nachrichtenclientanmeldeinformationstyp für den WCF-Basic-Adapter ist Certificate. Dieser Modus erfordert den HTTP-Transport. Bei Verwendung dieses Sicherheitsmodus muss das Dienstzertifikat für diesen Empfangsspeicherort über die Eigenschaft Dienstzertifikat – Fingerabdruck bereitgestellt werden. - TransportWithMessageCredential: Integrität, Vertraulichkeit und Dienstauthentifizierung werden vom HTTPS-Transport bereitgestellt. Um diesen Modus zu verwenden, muss SSL (Secure Sockets Layer) in den Microsoft Internetinformationsdiensten (IIS) eingerichtet sein. Die Standardeinstellung ist Transport.
Certificate	Geben Sie die Sicherheitsoptionen auf Nachrichtenebene nur an, wenn Sie den Sicherheitsmodus oben auf Nachricht oder TransportWithMessageCredential festlegen. Gültige Werte sind: - UserName: Ermöglicht diesem Empfangsspeicherort, dass Clients mithilfe der Anmeldeinformationen von Benutzername authentifiziert werden müssen. Sie müssen die Domänen- oder lokalen Benutzerkonten erstellen, die den Clientanmeldeinformationen entsprechen. - Zertifikat: Clients werden mithilfe des Clientzertifikats an diesem Empfangsspeicherort authentifiziert. Die Zertifizierungsstellen-Zertifikatkette für die X.509-Clientzertifikate muss im Speicher für vertrauenswürdige Stammzertifizierungsstellen dieses Computers installiert werden, sodass die Clients für diesen Empfangsspeicherort authentifiziert werden können. Der Standardwert ist UserName.
Algorithmuspaket	Geben Sie die Nachrichtenverschlüsselungs- und Schlüsselumbruchalgorithmen nur an, wenn Sie den oben genannten Sicherheitsmodus auf Message oder TransportWithMessageCredential festlegen. Dies gilt nicht, wenn Sie den Sicherheitsmodus auf Keine oder Transport festlegen. Diese Algorithmen sind den Algorithmen in der Spezifikation der Sicherheitsrichtliniensprache (WS-SecurityPolicy) zugeordnet. Mögliche Werte: - Basic128: Verwenden Sie die Aes128-Verschlüsselung, Sha1 für den Nachrichtendigest und Rsa-oaep-mgf1p für den Schlüsselumbruch. - Basic128Rsa15: Verwenden Sie Aes128 für die Nachrichtenverschlüsselung, Sha1 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - Basic128Sha256: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa-oaep-mgf1p für Schlüsselumbruch. - Basic128Sha256Rsa15: Verwenden Sie Aes128 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - Basic192: Verwenden Sie die Aes192-Verschlüsselung, Sha1 für den Nachrichtendigest und Rsa-oaep-mgf1p für den Schlüsselumbruch. - Basic192Rsa15: Verwenden Sie Aes192 für die Nachrichtenverschlüsselung, Sha1 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - Basic192Sha256: Verwenden Sie Aes192 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa-oaep-mgf1p für Schlüsselumbruch. - Basic192Sha256Rsa15: Verwenden Sie Aes192 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - Basic256: Verwenden Sie die Aes256-Verschlüsselung, Sha1 für den Nachrichtendigest und Rsa-oaep-mgf1p für den Schlüsselumbruch. - Basic256Rsa15: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha1 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - Basic256Sha256: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa-oaep-mgf1p für schlüsselumbruch. - Basic256Sha256Rsa15: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - TripleDes: Verwenden Sie TripleDes-Verschlüsselung, Sha1 für Den Nachrichtendigest und Rsa-oaep-mgf1p für Schlüsselumbruch. - TripleDesRsa15: Verwenden Sie die TripleDes-Verschlüsselung, Sha1 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. - TripleDesSha256: Verwenden Sie TripleDes für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa-oaep-mgf1p für Schlüsselumbruch. - TripleDesSha256Rsa15: Verwenden Sie TripleDes für die Nachrichtenverschlüsselung, Sha256 für den Nachrichtendigest und Rsa15 für Schlüsselumbruch. Der Standardwert ist Basic256.
Dienstzertifikat - Fingerabdruck	Gibt den Fingerabdruck des X.509-Zertifikats für diesen Empfangsspeicherort an, mit dem die Clients den Dienst authentifizieren. Sie können den Fingerabdruck auswählen, indem Sie im Verzeichnis Aktueller Benutzer zum persönlichen Speicher navigieren. Verwenden Sie dazu die Schaltfläche Durchsuchen . Hinweis: Sie müssen diese Eigenschaft nur festlegen, wenn Sie den sicherheitsbasierten Modus oben auf Message oder TransportWithMessageCredential festlegen. Dies gilt nicht, wenn Sie den Sicherheitsmodus auf Keine oder Transport festlegen. Hinweis: Sie müssen das Dienstzertifikat am Aktuellen Benutzerspeicherort des Benutzerkontos für den Empfangshandler installieren, der diesen Empfangsspeicherort hosten. Mindestlänge: 0 Maximale Länge: 40 Der Standardwert ist eine leere Zeichenfolge.
Relayclient-Authentifizierungstyp	Geben Sie diese Option an, um die Authentifizierung mit dem Service Bus-Relayendpunkt vom Empfangsspeicherort der Nachricht auszuführen. Gültige Werte sind: - Keine: Es ist keine Authentifizierung erforderlich. - RelayAccessToken: Geben Sie dies an, um ein Sicherheitstoken für die Autorisierung mit dem Service Bus Relay-Endpunkt zu verwenden. Der Standardwert ist RelayAccessToken.
Dienstermittlung aktivieren	Aktivieren Sie dieses Kontrollkästchen, um anzugeben, ob das Verhalten des Diensts in der Dienstregistrierung veröffentlicht wird. - Anzeigename : Geben Sie den Namen an, mit dem der Dienst in der Dienstregistrierung veröffentlicht wird. - Ermittlungsmodus : Legen Sie den Ermittlungsmodus für den Dienst fest, der in der Dienstregistrierung veröffentlicht wurde. Weitere Informationen finden Sie unter DiscoveryType-Enumeration.
Zugriffssteuerungsdienst	Gilt für BizTalk Server 2013 R2 und BizTalk Server 2013. Wenn Sie Authentifizierungstyp des Relayclients auf RelayAccessTokenfestlegen, klicken Sie auf die Schaltfläche Bearbeiten , und geben Sie dann die folgenden Details an: - Access Control Dienst-STS-URI: Legen Sie diesen wert auf `https://<Namespace>-sb.accesscontrol.windows.net/`fest, wobei <namespace> Ihr Service Bus-Namespace ist. - Ausstellername : Geben Sie den Ausstellernamen an. Diese Angabe wird normalerweise auf den Besitzer festgelegt. - Ausstellerschlüssel : Geben Sie den Ausstellerschlüssel an.
Service Bus-Verbindungsinformationen	Neu ab BizTalk Server 2016. Wählen Sie die Shared Access Signature (SAS) oder Access Control Service (ACS) des Service Bus-Namespaces aus. Wählen Sie eine Option und dann Bearbeiten aus, um die wichtigsten Informationen einzugeben: - Shared Access Signature : Geben Sie den Namen des Zugriffsschlüssels und den Zugriffsschlüssel ein. Beide Werte werden im Azure-Portal aufgeführt. - Access Control Dienst: Geben Sie den STS-URI (`https://<yourNamespace>-sb.accesscontrol.windows.net/`), den Ausstellernamen und den Ausstellerschlüssel ein. Verwenden Sie Windows PowerShell, um diese Werte abzurufen, wie unter SB-Messaging-Adapter beschrieben.

Geben Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Nachrichten die Datenauswahl für das SOAP-Body-Element an.

Option	Aufgabe
Umschlag -- ganze <Seife:Umschlag>	Erstellen Sie den BizTalk-Nachrichtentextteil aus dem gesamten SOAP-Umschlag einer eingehenden Nachricht. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Text -- Inhalt von <soap:Body-Element>	Verwenden Sie den Inhalt des SOAP-Body-Elements einer eingehenden Nachricht, um den BizTalk-Nachrichtentextteil zu erstellen. Wenn das Body-Element mehr als ein untergeordnetes Element aufweist, wird nur das erste Element zum BizTalk-Nachrichtentextteil. Dies ist die Standardeinstellung.
Pfad - Inhalt wird von Textpfad erkannt	Verwenden Sie den Textpfadausdruck im Textfeld Textpfadausdruck , um den BizTalk-Nachrichtentextteil zu erstellen. Der Textpfadausdruck wird anhand des unmittelbar untergeordneten Elements des SOAP-Body-Elements einer eingehenden Nachricht ausgewertet. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Textpfadausdruck	Geben Sie den Textpfadausdruck ein, um einen bestimmten Teil einer eingehenden Nachricht festzulegen, der zur Erstellung des Textteils einer BizTalk-Nachricht verwendet wird. Dieser Textpfadausdruck wird anhand des unmittelbar untergeordneten Elements des SOAP-Body-Elements einer eingehenden Nachricht ausgewertet. Wenn dieser Textpfadausdruck mehrere Knoten zurückgibt, wird nur der erste Knoten für den Textteil der BizTalk-Nachricht ausgewählt. Diese Eigenschaft ist erforderlich, wenn die Option Pfad – Inhalt nach Textpfad ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 32767 Der Standardwert ist eine leere Zeichenfolge.
Knotencodierung	Geben Sie den Codierungstyp an, den der WCF-BasicHttpRelay Empfangsadapter verwendet, um den Knoten zu decodieren, der durch den Textpfadausdruck im Textfeld Textpfadausdruck identifiziert wird. Diese Eigenschaft ist erforderlich, wenn die Option Pfad – Inhalt nach Textpfad ausgewählt ist. Gültige Werte sind: - Base64: Base64-Codierung. - Hexadezimalcodierung. - Zeichenfolge: Textcodierung – UTF-8 - XML: Die WCF-Adapter erstellen den BizTalk-Nachrichtentext mit dem äußeren XML des Knotens, der durch den Textpfadausdruck im Textfeld Textpfadausdruck ausgewählt wird. Der Standardwert ist XML.
Text - Text der BizTalk-Antwortnachricht	Verwenden Sie den BizTalk-Nachrichtentextteil, um den Inhalt des SOAP-Body-Elements einer ausgehenden Antwortnachricht zu erstellen. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Dies ist die Standardeinstellung.
Vorlage - Inhalt wird durch Vorlage festgelegt	Verwenden Sie die im XML-Textfeld angegebene Vorlage, um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht zu erstellen. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
XML	Geben Sie die XML-formatierte Vorlage für den Inhalt des SOAP-Body-Elements einer ausgehenden Nachricht ein. Diese Eigenschaft ist erforderlich, wenn die Option Vorlage –- BizTalk-Antwortnachrichtentext ausgewählt ist. Diese Eigenschaft gilt nur für Empfangsspeicherorte vom Typ "Anforderungsantwort". Typ: String Mindestlänge: 0 Maximale Länge: 32767 Der Standardwert ist `<bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">`.
Anforderungsnachricht bei Fehler anhalten	Gibt an, ob Anforderungsnachrichten angehalten werden sollen, bei denen bei der Eingangsverarbeitung ein Fehler in der Empfangspipeline oder beim Weiterleiten aufgetreten ist. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Ausnahmedetails in Fehlermeldung einbeziehen	Legen Sie fest, ob SOAP-Fehler zurückgegeben werden, wenn beim einfachen Debuggen ein Fehler auftritt. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.

Klicken Sie auf OK.
Geben Sie in das Dialogfeld Eigenschaften für Empfangsspeicherort entsprechende Werte ein, um die Konfiguration des Empfangsspeicherorts abzuschließen, und klicken Sie auf OK , um die Einstellungen zu speichern. Informationen zum Dialogfeld Eigenschaften für Empfangsspeicherort finden Sie unter Erstellen eines Empfangsspeicherorts.

Erstellen des Sendeports

Erstellen Sie in der BizTalk-Verwaltungskonsole einen neuen Sendeport, oder doppelklicken Sie auf einen vorhandenen Sendeport, um diesen zu ändern. Weitere Informationen finden Sie unter Erstellen eines Sendeports. Konfigurieren Sie alle Sendeportoptionen, und geben Sie WCF-BasicHttpRelay für die Option Typ im Abschnitt Transport der Registerkarte Allgemein an.
Klicken Sie auf der Registerkarte Allgemein im Abschnitt Transport auf die Schaltfläche Konfigurieren .

Geben Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Allgemein Folgendes an:

Option	Aufgabe
Adresse (URI)	Erforderlich. Geben Sie die URL an, unter der der Relayendpunkt auf Service Bus bereitgestellt wird. Die URL weist normalerweise das folgende Format auf: `https://<namespace>.servicebus.windows.net/`
Endpunktidentität	Optional. Gibt die Endpunktidentität an. Diese Einstellungen ermöglichen diesem Sendeport die Authentifizierung mit dem Endpunkt. Während des Handshakevorgangs zwischen dem Endpunkt und dem Sendeport stellt die Windows Communication Foundation-Infrastruktur (WCF) sicher, dass die Identität des Endpunkts mit den Werten dieses Elements übereinstimmt. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Aktion	Geben Sie das SOAPAction-HTTP-Headerfeld für ausgehende Nachrichten an. Diese Eigenschaft kann auch über die Nachrichtenkontexteigenschaft WCF festgelegt werden . Aktion in einer Pipeline oder Orchestrierung. Sie können diesen Wert auf zwei verschiedene Arten angeben: das einzelne Aktionsformat und das Aktionszuordnungsformat. Wenn Sie diese Eigenschaft im einzelnen Aktionsformat festlegen, z. B. , `http://contoso.com/Svc/Op1`wird der SOAPAction-Header für ausgehende Nachrichten immer auf den in dieser Eigenschaft angegebenen Wert festgelegt. Wenn Sie diese Eigenschaft im Aktionszuordnungsformat festlegen, wird der ausgehende SOAPAction-Header vom BTS bestimmt. Vorgangskontexteigenschaft . Beispielsweise, wenn diese Eigenschaft auf das folgende XML-Format und das BTS festgelegt ist. Die Vorgangseigenschaft ist auf Op1 festgelegt, die der WCF-Sendeadapter für den ausgehenden SOAPAction-Header verwendet`http://contoso.com/Svc/Op1`. `<BtsActionMapping> <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" /> <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping>` Wenn ausgehende Nachrichten von einem Orchestrierungsport stammen, legen Orchestrierungsinstanzen den BTS dynamisch fest. Operation-Eigenschaft mit dem Vorgangsnamen des Ports. Wenn ausgehende Nachrichten mit inhaltsbasiertem Routing weitergeleitet werden, können Sie btS festlegen. Vorgangseigenschaft in Pipelinekomponenten. Wichtig: Service Bus schreibt vor, dass beim Senden von Nachrichten an Relayendpunkte eine SOAP-Aktion festgelegt wird. Mindestlänge: 0 Maximale Länge: 32767 Der Standardwert ist eine leere Zeichenfolge.

Konfigurieren Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Bindung die Timeout- und Codierungseigenschaften.

Option	Aufgabe
Timeout des Öffnungsvorgangs (hh:mm:ss)	Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Öffnen eines Kanals zur Verfügung steht. Dieser Wert sollte größer oder gleich System.TimeSpan.Zerosein. Standardwert: 00:01:00 Maximalwert: 23:59:59
Timeout des Sendevorgangs (hh:mm:ss)	Legt einen Wert für den Zeitraum fest, der bis zum Abschluss eines Sendevorgangs zur Verfügung steht. Dieser Wert sollte größer oder gleich System.TimeSpan.Zerosein. Wenn Sie einen Sendeport vom Typ "Antwort anfragen" verwenden, gibt dieser Wert den Zeitraum an, in dem die gesamte Interaktion abgeschlossen sein muss, auch wenn eine umfangreiche Nachricht vom Dienst zurückgegeben wird. Standardwert: 00:01:00 Maximalwert: 23:59:59
Timeout des Schließvorgangs (hh:mm:ss)	Legt einen Wert für den Zeitraum fest, der bis zum vollständigen Schließen eines Kanals zur Verfügung steht. Dieser Wert sollte größer oder gleich System.TimeSpan.Zero sein. Standardwert: 00:01:00 Maximalwert: 23:59:59
Maximalgröße empfangener Nachrichten (Byte)	Gibt die Maximalgröße in Bytes für Nachrichten einschließlich der Header an, die über das Netzwerk empfangen werden können. Die Nachrichtengröße wird durch den für jede Nachricht reservierten Arbeitsspeicher begrenzt. Sie können diese Eigenschaft verwenden, um das Risiko für Denial-of-Service-Angriffe (DoS-Angriffe) einzuschränken. Der WCF-BasicHttpRelay-Adapter nutzt die BasicHttpBinding-Klasse im gepufferten Übertragungsmodus, um mit einem Endpunkt zu kommunizieren. Für den gepufferten Transportmodus ist die BasicHttpBinding.MaxBufferSize-Eigenschaft immer gleich dem Wert dieser Eigenschaft. Standardwert: 65536 Maximalwert: 2147483647
Nachrichtencodierung	Hier geben Sie den Encoder an, der zum Codieren der SOAP-Nachricht verwendet werden soll. Gültige Werte sind: - Text: Verwenden Sie einen Textnachrichtenencoder. - Mtom: Verwenden Sie einen MTOM-Encoder (Message Transmission Organization Mechanism 1.0). Standardwert: Text
Textcodierung	Geben Sie die Zeichensatzcodierung an, die zum Senden von Nachrichten in der Bindung verwendet werden soll, wenn die Eigenschaft Message-Codierung auf Text festgelegt ist. Gültige Werte sind: - utf-16BE (unicodeFFFE): Unicode BigEndian-Codierung. - utf-16: 16-Bit-Codierung. - utf-8: 8-Bit-Codierung Standardwert: utf-8

Definieren Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Sicherheit die Sicherheitsfunktionen des WCF-BasicHttpRelay Sendeports.

Option	Aufgabe
Sicherheitsmodus	Gibt den verwendeten Sicherheitstyp an. Gültige Werte sind: - Keine: Nachrichten werden während der Übertragung nicht gesichert. - Transport: Die Sicherheit wird mithilfe des HTTPS-Transports bereitgestellt. Die SOAP-Nachrichten werden bei der Verwendung von HTTPS gesichert. Damit der Dienst am Sendeport mit seinem Zertifikat authentifiziert werden kann, muss die Zertifizierungsstellen-Zertifikatkette für das X.509-Zertifikat des Diensts im Zertifikatspeicher für vertrauenswürdige Stammzertifizierungsstellen dieses Computers installiert sein. - Nachricht: Die Sicherheit wird mithilfe der SOAP-Nachrichtensicherheit bereitgestellt. Standardmäßig ist das SOAP-Body-Element verschlüsselt und signiert. Der einzige gültige Nachrichtenclientanmeldeinformationstyp für den WCF-BasicHttpRelay Sendeadapter ist Certificate. Dieser Modus erfordert den HTTP-Transport. - TransportWithMessageCredential: Integrität, Vertraulichkeit und Dienstauthentifizierung werden vom HTTPS-Transport bereitgestellt. Die Zertifizierungsstellenzertifikatkette für das X.509-Zertifikat des Diensts muss im Zertifikatspeicher vertrauenswürdiger Stammzertifizierungsstellen auf diesem Computer installiert sein, damit der Dienst mithilfe des Zertifikats des Diensts am Sendeport authentifiziert werden kann. Die Sendeportauthentifizierung wird über die SOAP-Nachrichtensicherheit bereitgestellt. Der Standardwert ist None (Kein).
Certificate	Geben Sie die Sicherheitsoptionen auf Nachrichtenebene nur an, wenn Sie den Sicherheitsmodus oben auf Nachricht oder TransportWithMessageCredential festlegen. Gültige Werte sind: - Benutzername: Dieser Sendeport wird beim Endpunkt mit Anmeldeinformationen für Benutzername authentifiziert. Dies wird für den WCF-BasicHttpRelay-Sendeadapter nicht unterstützt. - Zertifikat: Dieser Sendeport wird mit dem Clientzertifikat authentifiziert, das über die Eigenschaft Clientzertifikat – Fingerabdruck angegeben wird. Darüber hinaus muss das Dienstzertifikat bei Verwendung dieses Anmeldeinformationstyps über die Eigenschaft Dienstzertifikat – Fingerabdruck bereitgestellt werden. Der Standardwert ist UserName.
Algorithmuspaket	Legt Nachrichtenverschlüsselung und Schlüsselverpackungsalgorithmen fest. Diese Algorithmen sind den Algorithmen in der Spezifikation der Sicherheitsrichtliniensprache (WS-SecurityPolicy) zugeordnet. Mögliche Werte: - Basic128: Verwenden Sie die Aes128-Verschlüsselung, Sha1 für den Nachrichten digest und Rsa-oaep-mgf1p als Schlüsselumbruch. - Basic128Rsa15: Verwenden Sie Aes128 für die Nachrichtenverschlüsselung, Sha1 für den Nachrichten digest und Rsa15 als Schlüsselumbruch. - Basic128Sha256: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa-oaep-mgf1p für Schlüsselumbruch. - Basic128Sha256Rsa15: Verwenden Sie Aes128 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa15 für Schlüsselumbruch. - Basic192: Verwenden Sie die Aes192-Verschlüsselung, Sha1 für den Nachrichten digest und Rsa-oaep-mgf1p als Schlüsselumbruch. - Basic192Rsa15: Verwenden Sie Aes192 für die Nachrichtenverschlüsselung, Sha1 für den Nachrichten digest und Rsa15 als Schlüsselumbruch. - Basic192Sha256: Verwenden Sie Aes192 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa-oaep-mgf1p für Schlüsselumbruch. - Basic192Sha256Rsa15: Verwenden Sie Aes192 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa15 für Schlüsselumbruch. - Basic256: Verwenden Sie die Aes256-Verschlüsselung, Sha1 für den Nachrichten digest und Rsa-oaep-mgf1p für Schlüsselumbruch. - Basic256Rsa15: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha1 für den Nachrichten digest und Rsa15 für Schlüsselumbruch. - Basic256Sha256: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa-oaep-mgf1p als Schlüsselumbruch. - Basic256Sha256Rsa15: Verwenden Sie Aes256 für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa15 als Schlüsselumbruch. - TripleDes: Verwenden Sie die TripleDes-Verschlüsselung, Sha1 für den Nachrichten digest, Rsa-oaep-mgf1p für Schlüsselumbruch. - TripleDesRsa15: Verwenden Sie die TripleDes-Verschlüsselung, Sha1 für den Nachrichten digest und Rsa15 für Schlüsselumbruch. - TripleDesSha256: Verwenden Sie TripleDes für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa-oaep-mgf1p für Schlüsselumbruch. - TripleDesSha256Rsa15: Verwenden Sie TripleDes für die Nachrichtenverschlüsselung, Sha256 für den Nachrichten digest und Rsa15 für Schlüsselumbruch. Der Standardwert ist Basic256.
Clientzertifikat – Fingerabdruck	Gibt den Fingerabdruck des X.509-Zertifikats für die Authentifizierung dieses Sendeports mit dem Endpunkt an. Sie können den Fingerabdruck auswählen, indem Sie mit der Schaltfläche Durchsuchen zu Mein Geschäft im Speicherort Aktueller Benutzer navigieren. Hinweis: Sie müssen das Clientzertifikat im Aktuellen Benutzerspeicherort des Benutzerkontos für den Sendehandler installieren, der diesen Sendeport hostt. Mindestlänge: 0 Maximale Länge: 40 Der Standardwert ist eine leere Zeichenfolge.
Dienstzertifikat - Fingerabdruck	Legt den Fingerabdruck des X.509-Zertifikats für die Authentifizierung des Endpunkts fest, an den dieser Sendeport Nachrichten sendet. Sie können den Fingerabdruck auswählen, indem Sie mit der Schaltfläche Durchsuchen zum Speicher Andere Personen am Speicherort Lokaler Computer navigieren. Mindestlänge: 0 Maximale Länge: 40 Der Standardwert ist eine leere Zeichenfolge.
Benutzeranmeldeinformationen	Legt die Anmeldeinformationen für das Senden von Nachrichten fest. Sie können die Eigenschaft angeben, indem Sie auf die Schaltfläche Bearbeiten klicken. Sie müssen die Anmeldeinformationen festlegen, wenn Sie die Option Benutzername für den Typ Nachrichtenclientanmeldeinformationen ausgewählt haben. Der Standardwert ist Nicht einmaliges Anmelden verwenden.
ACS-Dienstidentität verwenden	Gilt für BizTalk Server 2013 R2 und BizTalk Server 2013. Aktivieren Sie dieses Kontrollkästchen, und klicken Sie auf Bearbeiten , und geben Sie die folgenden Werte an, um sich bei Service Bus zu authentifizieren. - Access Control Dienst-STS-Uri: Legen Sie diesen auf fest`https://<Namespace>-sb.accesscontrol.windows.net/`, wobei <Namespace> Ihr Service Bus-Namespace ist. - Ausstellername : Geben Sie den Ausstellernamen an. Diese Angabe wird normalerweise auf den Besitzer festgelegt. - Ausstellerschlüssel : Geben Sie den Ausstellerschlüssel an.
Service Bus-Verbindungsinformationen	Neu ab BizTalk Server 2016. Wählen Sie die Sas (Shared Access Signature) oder Access Control Service (ACS) des Service Bus-Namespaces aus. Wählen Sie eine Option aus, und wählen Sie dann Bearbeiten aus, um die Schlüsselinformationen einzugeben: - Shared Access Signature : Geben Sie den Namen des Zugriffsschlüssels und den Zugriffsschlüssel ein. Beide Werte werden im Azure-Portal aufgeführt. - Access Control Dienst: Geben Sie den STS-URI (`https://<yourNamespace>-sb.accesscontrol.windows.net/`), den Ausstellernamen und den Ausstellerschlüssel ein. Verwenden Sie Windows PowerShell, um diese Werte abzurufen, wie unter SB-Messaging-Adapter beschrieben.

Konfigurieren Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Proxy die Proxyeinstellung für den WCF-BasicHttpRelay Sendeports.

Option	Aufgabe
Verwenden von Proxyeinstellungen für Sendehandler	Legen Sie hiermit fest, ob dieser Sendeport die Proxyeinstellungen im Sendehandler verwendet, der als Host für diesen Sendeport dient. Dies ist die Standardeinstellung.
Proxy nicht verwenden	Geben Sie an, ob dieser Sendeport einen Proxyserver verwendet. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Proxy verwenden	Geben Sie an, ob dieser Sendeport den in der Address-Eigenschaft angegebenen Proxyserver verwendet. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Adresse	Geben Sie die Adresse des Proxyservers an. Verwenden Sie je nach Sicherheitskonfiguration das https- oder das HTTP-Schema. Nach dieser Adresse kann ein Doppelpunkt und eine Portnummer stehen. Beispiel: http://127.0.0.1:8080. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Maximale Länge: 256 Der Standardwert ist eine leere Zeichenfolge.
Benutzername	Geben Sie den Benutzernamen für die Authentifizierung an. Bei Verwendung der integrierten Authentifizierung enthält der Benutzername die Domäne (im Format Domäne\Benutzername). Bei Verwendung der Authentifizierung vom Typ "Standard" oder "Digest" ist Domäne\ im Benutzernamen nicht enthalten. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Hinweis: Der WCF-BasicHttpRelay-Sendeadapter verwendet die Standardauthentifizierung für den Proxy. Typ: String Mindestlänge: 0 Maximale Länge: 256 Der Standardwert ist eine leere Zeichenfolge.
Kennwort	Geben Sie das Kennwort für die Authentifizierung an. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 256 Der Standardwert ist eine leere Zeichenfolge.

Geben Sie im Dialogfeld WCF-BasicHttpRelay-Transporteigenschaften auf der Registerkarte Nachrichten die Datenauswahl für das SOAP-Body-Element an.

Option	Aufgabe
Text - Text der BizTalk-Anforderungsnachricht	Verwenden Sie den BizTalk-Nachrichtentextteil, um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht zu erstellen. Dies ist die Standardeinstellung.
Vorlage - Inhalt wird durch Vorlage festgelegt	Verwenden Sie die im XML-Textfeld angegebene Vorlage, um den Inhalt des SOAP-Body-Elements für eine ausgehende Nachricht zu erstellen. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
XML	Geben Sie die XML-formatierte Vorlage für den Inhalt des SOAP ody-Elements einer ausgehenden Nachricht ein. Diese Eigenschaft ist erforderlich, wenn die Option Vorlage -- BizTalk-Antwortnachrichtentext ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 32767 Der Standardwert ist `<bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>`.
Umschlag -- ganze <Seife:Umschlag>	Erstellen Sie den BizTalk-Nachrichtentextteil aus dem gesamten SOAP-Umschlag einer eingehenden Nachricht. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Text -- Inhalt von <soap:Body-Element>	Verwenden Sie den Inhalt des SOAP-Body-Elements einer eingehenden Nachricht, um den BizTalk-Nachrichtentextteil zu erstellen. Wenn das Body-Element mehr als ein untergeordnetes Element aufweist, wird nur das erste Element zum BizTalk-Nachrichtentextteil. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Dies ist die Standardeinstellung.
Pfad - Inhalt wird von Textpfad erkannt	Verwenden Sie den Textpfadausdruck im Textfeld Textpfadausdruck , um den BizTalk-Nachrichtentextteil zu erstellen. Der Textpfadausdruck wird anhand des unmittelbar untergeordneten Elements des SOAP-Body-Elements einer eingehenden Nachricht ausgewertet. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Textpfadausdruck	Geben Sie den Textpfadausdruck ein, um einen bestimmten Teil einer eingehenden Nachricht festzulegen, der zur Erstellung des Textteils einer BizTalk-Nachricht verwendet wird. Dieser Textpfadausdruck wird anhand des unmittelbar untergeordneten Elements des SOAP-Textknotens einer eingehenden Nachricht ausgewertet. Wenn dieser Textpfadausdruck mehrere Knoten zurückgibt, wird nur der erste Knoten für den Textteil der BizTalk-Nachricht ausgewählt. Diese Eigenschaft ist erforderlich, wenn die Option Pfad – Inhalt nach Textpfad ausgewählt ist. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Typ: String Mindestlänge: 0 Maximale Länge: 32767 Der Standardwert ist eine leere Zeichenfolge.
Knotencodierung	Geben Sie den Codierungstyp an, den der WCF-BasicHttpRelay Sendeadapter zum Decodieren des Knotens verwendet, der durch den Textpfadausdruck im Textfeld Textpfadausdruck identifiziert wird. Diese Eigenschaft ist erforderlich, wenn die Option Pfad – Inhalt nach Textpfad ausgewählt ist. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. Gültige Werte sind: - Base64: Base64-Codierung. - Hexadezimalcodierung. - Zeichenfolge: Textcodierung – UTF-8 - XML: Die WCF-Adapter erstellen den BizTalk-Nachrichtentext mit dem äußeren XML des Knotens, der durch den Textpfadausdruck im Textfeld Textpfadausdruck ausgewählt wird. Der Standardwert ist XML.
Verteilung von Fehlernachricht	Aktivieren Sie dieses Kontrollkästchen, wenn die Nachrichten, die nicht gesendet werden, an eine abonnierende Anwendung (z. B. ein anderer Empfangsport oder ein Orchestrierungsplan) weitergeleitet werden sollen. Deaktivieren Sie das Kontrollkästchen, um nicht verarbeitete Nachrichten anzuhalten und eine negative Bestätigung zu generieren. Diese Eigenschaft ist nur für Ports vom Typ Antwort anfragen gültig. In der Standardeinstellung ist die Eigenschaft aktiviert.

Klicken Sie erneut auf OK und erneut auf OK , um die Einstellungen zu speichern.

Hinzufügen eines Proxys zum Sendehandler

Sie können dem Sendeport oder dem Sendehandler einen Proxy hinzufügen. Wenn Sie einen Proxy am Sendeport hinzufügen, überspringen Sie diesen Abschnitt.

Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Plattformeinstellungen und dann Adapter.
Wählen Sie WCF-BasicHttpRelay und dann den Sendehandler aus.
Wählen Sie unter Eigenschaften des Adapterhandlers auf der Registerkarte Allgemein die Option Eigenschaften aus.

Führen Sie auf der Registerkarte Proxy die folgenden Schritte aus.

Option	Aufgabe
Proxy verwenden	Geben Sie an, ob dieser Sendehandler einen Proxyserver verwendet. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.
Adresse	Geben Sie die Adresse des Proxyservers an. Verwenden Sie je nach Sicherheitskonfiguration das HTTPS- oder HTTP-Schema. Nach dieser Adresse kann ein Doppelpunkt und eine Portnummer stehen. Beispiel: http://127.0.0.1:8080. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Maximale Länge: 256 Der Standardwert ist eine leere Zeichenfolge.
Benutzername	Geben Sie den Benutzernamen für die Authentifizierung an. Bei Verwendung der integrierten oder Standardauthentifizierung enthält der Benutzername die Domäne (im Format Domäne\Benutzername). Wird Digestauthentifizierung verwendet, ist Domäne\ im Benutzernamen nicht enthalten. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 256 Der Standardwert ist eine leere Zeichenfolge.
Kennwort	Geben Sie das Kennwort für die Authentifizierung an. Diese Eigenschaft erfordert nur einen Wert, wenn Proxy verwenden ausgewählt ist. Typ: String Mindestlänge: 0 Maximale Länge: 256 Der Standardwert ist eine leere Zeichenfolge.

Klicken Sie auf OK , bis Sie alle Dialogfelder beenden.

Weitere Informationen

SB-Messaging-Adapter

Verwenden von Adaptern

Freigeben über