WCF-BasicHttp-Adapter

Microsoft BizTalk Server verwendet den WCF-BasicHttp-Adapter zum Empfangen und Senden von WCF-Dienstanforderungen über die BasicHttpBinding-Klasse. Mit dem WCF-BasicHttp-Adapter können Sie Orchestrierungen und Schemas als WCF-Dienste veröffentlichen und externe WCF-Dienste mit BasicHttpBinding nutzen.

Sie können den WCF-BasicHttp-Adapter für die computerübergreifende Kommunikation mit früheren ASMX-basierten Webdiensten und Clients verwenden, die WS-I Basic Profile 1.1 entsprechen. Die Kommunikation erfolgt entweder über HTTP oder HTTPS mit Textcodierung. Es ist aber nicht möglich, die Funktionen zu nutzen, die von WS-*-Protokollen unterstützt werden.

In der folgenden Tabelle sind die Merkmale des WCF-BasicHttp-Adapters zusammengefasst:

BESCHREIBUNG	Merkmal
Interoperabilitätsstufe	Basic Profile
Nachrichtencodierung	Text oder MTOM
Grenze	Computerübergreifend
Transportprotokoll	HTTP oder HTTPS
Sicherheitsmodus	None, Message, Transport, TransportWithMessageCredential und TransportCredentialOnly
Authentifizierungsmechanismus für Client	Transportsicherheit und Nachrichtensicherheit
Unterstützung für WS-ReliableMessaging	No
Unterstützung für WS-AtomicTransaction	No
Unterstützung für unidirektionales Messaging	Yes
Unterstützung für bidirektionales Messaging	Yes
Hosttyp für Empfangsadapter	Isolated
Hosttyp für Sendeadapter	In-Process

Der WCF-BasicHttp Adapter besteht aus zwei Adaptern – einem Empfangsadapter und einem Sendeadapter.

In diesem Thema erfahren Sie, wie Sie den Empfangsspeicherort und den Sendeport mithilfe der BizTalk-Verwaltung erstellen. Sie können auch den Empfangsspeicherort erstellen und den Port programmgesteuert senden.

Voraussetzungen

• Ab BizTalk Server 2016 kann dieser Sendeadapter 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.

• Der WCF-BasicHttp-Adapter wird in den folgenden Szenarien dem SOAP-Adapter vorgezogen:

  • WCF-Adapter:Dokumente pro Sekunde sind im Allgemeinen besser als SOAP-Adapter.
  • Der SOAP-Adapter hat den Nachteil der Serialisierung und Deserialisierung von Nachrichten zwischen .NET-Typen und XML-Rohdaten. die in einigen Fällen zu unerwünschten Datenänderungen führen können. WCF-Adapter sind so konzipiert, dass sie den Datenstrom beibehalten.
  • Ein Schema, das von einem WCF-Adapter veröffentlicht wird, ist weitestgehend mit dem Schema identisch, das im BizTalk-Laufzeitmodul verwendet wird. Der SOAP-Adapter gibt dagegen Metadaten zurück, die durch Rückgriff auf die .NET-Klassen generiert wurden, die zur Darstellung der Schemas erstellt wurden. Da .NET nicht alle Feinheiten von XSD-Schemas beibehält, entspricht die verfügbar gemachte WSDL möglicherweise nicht exakt den Schemas, die vom BizTalk-Laufzeitmodul verwendet werden.
  • Die Migration von WCF-BasicHttp zu WCF-WSHttp ist bei Bedarf einfacher.

• Der WCF-BasicHttp-Empfangsadapter wird dazu verwendet, WCF-Dienstanforderungen über HTTP oder HTTPS zu empfangen. Mit dem WCF-BasicHttp-Sendeadapter kann ein WCF-Dienst über den typenlosen Vertrag über HTTP oder HTTPS aufgerufen werden.

Erstellen des Empfangsspeicherorts

Dieser Empfangsspeicherort kann als unidirektionale oder Anforderungsantwort (bidirektionale) Konfiguration erfolgen.

Hinweis

Bevor Sie die folgenden Schritte ausführen, müssen Sie bereits einen Empfangsport hinzugefügt haben. Weitere Informationen finden Sie unter Erstellen eines Empfangsports.

Sie können den Empfangsspeicherort auch programmgesteuert erstellen.

1. Erweitern Sie in der BizTalk-Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Anwendungen, und erweitern Sie dann die Anwendung, in der Sie einen Empfangsspeicherort erstellen möchten.

2. Klicken Sie in der BizTalk-Verwaltungskonsole im linken Bereich auf den Knoten Empfangsport . Klicken Sie anschließend im rechten Bereich mit der rechten Maustaste auf den Empfangsport, der einem vorhandenen Empfangsspeicherort zugeordnet ist oder den Sie einem neuen Empfangsspeicherort zuordnen möchten, und klicken Sie dann auf Eigenschaften.

3. Wählen Sie im Dialogfeld Eigenschaften für Empfangsport im linken Bereich die Option Empfangsspeicherorteaus, und doppelklicken Sie im rechten Bereich auf einen vorhandenen Empfangsspeicherort, oder klicken Sie auf Neu , um einen neuen Empfangsspeicherort zu erstellen.

4. Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Abschnitt Transport neben Typ die Option WCF-BasicHttp aus der Dropdownliste aus, und klicken Sie dann auf Konfigurieren.

5. Konfigurieren Sie in WCF-BasicHttp Transport Properties auf der Registerkarte Allgemein die Endpunktadresse und die Dienstidentität für den WCF-BasicHttp Empfangsspeicherort:

   Hinweis

   Wenn Sie Transport oder TransportWithMessageCredential für den Sicherheitsmodus verwenden, müssen Sie SSL (Secure Sockets Layer) in Microsoft-Internetinformationsdienste (IIS) einrichten.

   Option	Aufgabe
   Adresse (URI)	Erforderlich. Geben Sie den URI dieses Empfangsspeicherorts an. Geben Sie das virtuelle Verzeichnis und den vom BizTalk-Assistenten für WCF-Dienstpublishing generierten SVC-Dateinamen an, z. B. /path/service.svc. Standardwert: / Mindestlänge: 1 Maximale Länge: 255
   Endpunktidentität	Optional. Geben Sie die Identität des Diensts an, den dieser Empfangsspeicherort bereitstellt, indem Sie auf die Schaltfläche Bearbeiten klicken. Die Werte, die für die Endpoint Identity-Eigenschaft angegeben werden können, unterscheiden sich je nach Sicherheitskonfiguration. Diese Einstellungen ermöglichen dem Client die Authentifizierung dieses Empfangsspeicherorts. Während des Handshakevorgangs zwischen Client und Dienst stellt die Windows Communication Foundation-Infrastruktur (WCF) sicher, dass die Identität des erwarteten Diensts mit den Werten dieses Elements übereinstimmt. Der Standardwert ist eine leere Zeichenfolge. Mindestlänge: 0 Maximale Länge: 32767

6. Konfigurieren Sie im Dialogfeld WCF-BasicHttp-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-BasicHttp-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). 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. Der Standardwert ist 200.

7. Definieren Sie im Dialogfeld WCF-BasicHttp Transport Properties auf der Registerkarte Sicherheit die Sicherheitsfunktionen:

   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. - TransportCredentialOnly: Dieser Modus bietet keine Nachrichtenintegrität und Vertraulichkeit. Er bietet dagegen HTTP-basierte Clientauthentifizierung. Dieser Modus sollte mit Vorsicht angewendet werden. Er sollte in Umgebungen verwendet werden, in denen die Transportsicherheit durch andere Verfahren (wie beispielsweise IPSec) gewährleistet ist und nur die Clientauthentifizierung über die WCF-Infrastruktur erfolgt. Wenn Sie zertifikat für die Eigenschaft Transportclientanmeldeinformationentyp in diesem Sicherheitsmodus auswählen, muss das Dienstzertifikat für diesen Empfangsspeicherort über die Eigenschaft Dienstzertifikat – Fingerabdruck bereitgestellt werden. Der Standardwert ist None (Kein).
   Typ der Anmeldeinformationen des Transportclients	Gibt den Typ der Anmeldeinformationen für die Clientauthentifizierung an. Gültige Werte sind: - Keine: Auf Transportebene wird keine Authentifizierung durchgeführt. - Basic: Standardauthentifizierung. Bei der Standardauthentifizierung werden Benutzernamen und Kennwörter als Nur-Text über das Netzwerk gesendet. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. - Digest: Digestauthentifizierung. Abgesehen davon, dass Kennwörter zur erhöhten Sicherheit als Hashwert über das Netzwerk gesendet werden, ist diese Authentifizierungsmethode der Standardauthentifizierung sehr ähnlich. Digestauthentifizierung ist nur für Domänen verfügbar, auf deren Domänencontrollern Windows Server-Betriebssystemauthentifizierung ausgeführt wird. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. - Ntlm: NTLM-Authentifizierung. Clients können Anmeldeinformationen senden, ohne ein Kennwort an diesen Empfangsspeicherort zu senden. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. - Windows: Integrierte Windows-Authentifizierung. Durch Windows Communication Foundation wird Kerberos oder NTLM ausgehandelt, wobei Kerberos bevorzugt wird, wenn eine Domäne vorhanden ist. Wenn Sie Kerberos verwenden möchten, muss der Client den Dienst mit einem Dienstprinzipalnamen (SPN) identifizieren. Sie müssen Domänen- oder lokale Benutzerkonten erstellen, die den Anmeldeinformationen entsprechen. - Zertifikat: Clientauthentifizierung mithilfe des Clientzertifikats. 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. Hinweis: Die Eigenschaft "Transport-Clientanmeldeinformationentyp " muss mit dem Authentifizierungsschema des virtuellen IIS-Verzeichnisses übereinstimmen, das diesen Empfangsspeicherort hostet. Wenn die Eigenschaft beispielsweise auf Windowsfestgelegt ist, muss zusätzlich Integrierte Windows-Authentifizierung für das als Host dienende virtuelle Verzeichnis aktiviert sein. Entsprechend muss anonymer Zugriff auf das als Host für den Empfangsspeicherort dienende virtuelle Verzeichnis zugelassen werden, wenn die Eigenschaft auf Keinefestgelegt ist. Der Standardwert ist None (Kein).
   Certificate	Gibt den Typ der Anmeldeinformationen an, der für die Clientauthentifizierung mit nachrichtenbasierter Sicherheit verwendet werden soll. Gültige Werte sind: - UserName: Erlauben Sie diesem Empfangsspeicherort, dass Clients mithilfe der Anmeldeinformationen von UserName 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	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 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 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.
   Verwenden des einmaligen Anmeldens	Verwendet Einmaliges Anmelden, um Clientanmeldeinformationen zur Bereitstellung eines SSO-Tickets abzurufen. Diese Option gilt nur für die im folgenden Abschnitt "Unterstützung des Einmaligen Anmeldens für Unternehmen für den WCF-BasicHttp-Empfangsadapter" aufgeführten Sicherheitskonfigurationen. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert.

   Unterstützung von Enterprise Single Sign-On für den WCF-BasicHttp-Empfangsadapter Dieser Adapter kann ein SSO-Ticket vom SSO-Server nur in den in der folgenden Tabelle gezeigten Sicherheitskonfigurationen ausstellen:

   Sicherheitsmodus	Typ der Anmeldeinformationen des Transportclients	Certificate
   Transport	Grundlegend	–
   Transport	Digest	–
   Transport	Ntlm	–
   Transport	Windows	–
   Transport	Certificate	–
   Meldung	–	UserName
   TransportWithMessageCredential	–	UserName
   TransportCredentialOnly	Grundlegend	–
   TransportCredentialOnly	Digest	–
   TransportCredentialOnly	Ntlm	–
   TransportCredentialOnly	Windows	–
   TransportCredentialOnly	Certificate	–

8. Geben Sie im Dialogfeld WCF-BasicHttp-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-BasicHttp 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.

Erstellen des Sendeports

Hinweis

Sie können den Sendeport auch programmgesteuert erstellen.

1. 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-BasicHttp für die Option Typ im Abschnitt Transport der Registerkarte Allgemein an.

2. Klicken Sie auf der Registerkarte Allgemein im Abschnitt Transport auf die Schaltfläche Konfigurieren neben Typ.

3. Konfigurieren Sie im Dialogfeld WCF-BasicHttp Transport Properties auf der Registerkarte Allgemein die Endpunktadresse, die Dienstidentität und den SOAPAction-HTTP-Header für den WCF-BasicHttp Sendeport:

   Hinweis

   Wenn Sie das https-Schema für die Address -Eigenschaft (URI) angeben, müssen Sie die Eigenschaft Security mode auf Transport oder TransportWithMessageCredential konfigurieren. Sie können die Registerkarte Sicherheit verwenden, um die Eigenschaft Sicherheitsmodus zu konfigurieren.

   Option	Aufgabe
   Adresse (URI)	Erforderlich. Geben Sie den voll gekennzeichneten URI für diesen Sendeport an. Verwenden Sie je nach Sicherheitskonfiguration das https- oder das HTTP-Schema. Maximale Länge: 255 Standardwert: http://localhost/
   Endpunktidentität	Optional. Gibt die Identität des Diensts an, der von diesem Sendeport erwartet wird. Diese Einstellungen ermöglichen dem Sendeport die Authentifizierung dieses Diensts. Während des Handshakevorgangs zwischen Client und Dienst stellt die Windows Communication Foundation-Infrastruktur (WCF) sicher, dass die Identität des erwarteten Diensts mit den Werten dieses Elements übereinstimmt. Die Werte, die für die Identity-Eigenschaft angegeben werden können, unterscheiden sich je nach Sicherheitskonfiguration. 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 beispielsweise im einzelnen Aktionsformat festlegen, http://contoso.com/Svc/Op1wird 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 . Wenn diese Eigenschaft beispielsweise auf das folgende XML-Format festgelegt ist, und das BTS. Die Vorgangseigenschaft ist auf Op1 festgelegt, die der WCF-Sendeadapter für den ausgehenden SOAPAction-Header verwendethttp://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. Mindestlänge: 0 Maximale Länge: 32767 Der Standardwert ist eine leere Zeichenfolge.

4. Konfigurieren Sie in WCF-BasicHttp Transport Properties 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-BasicHttp-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

5. Definieren Sie im Dialogfeld WCF-BasicHttp Transport Properties auf der Registerkarte Sicherheit die Sicherheitsfunktionen des WCF-BasicHttp 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-BasicHttp 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. - TransportCredentialOnly: Dieser Modus bietet keine Nachrichtenintegrität und Vertraulichkeit. Er bietet dagegen HTTP-basierte Clientauthentifizierung. Dieser Modus sollte mit Vorsicht angewendet werden. Er sollte in Umgebungen verwendet werden, in denen die Transportsicherheit durch andere Verfahren (wie beispielsweise IPSec) gewährleistet ist und nur die Clientauthentifizierung über die WCF-Infrastruktur erfolgt. Der Standardwert ist None (Kein).
   Typ der Anmeldeinformationen des Transportclients	Legt den Typ der Anmeldeinformationen für die Sendeportauthentifizierung fest. Gültige Werte sind: - Keine: Auf Transportebene wird keine Authentifizierung durchgeführt. - Basic: Standardauthentifizierung. Bei der Standardauthentifizierung werden Benutzernamen und Kennwörter als Nur-Text über das Netzwerk gesendet. Für diese Option muss die Eigenschaft Clientanmeldeinformationen konfiguriert werden. - Digest: Digestauthentifizierung. Abgesehen davon, dass Kennwörter zur erhöhten Sicherheit als Hashwert über das Netzwerk gesendet werden, ist diese Authentifizierungsmethode der Standardauthentifizierung sehr ähnlich. Digestauthentifizierung ist nur für Domänen verfügbar, auf deren Domänencontrollern Windows Server-Betriebssystemauthentifizierung ausgeführt wird. Für diese Option muss die Eigenschaft Clientanmeldeinformationen konfiguriert werden. - Ntlm: NTLM-Authentifizierung. Dienste können diesen Sendeport anhand des Benutzerkontos authentifizieren, unter dem der Sendeport ausgeführt wird. - Windows: Integrierte Windows-Authentifizierung. Dienste können diesen Sendeport anhand des Benutzerkontos authentifizieren, unter dem der Sendeport ausgeführt wird. - Zertifikat: Clientauthentifizierung mithilfe des Clientzertifikats, das über die Eigenschaft Clientzertifikat – Fingerabdruck angegeben wird. Bei Verwendung dieses Anmeldeinformationstyps muss das Dienstzertifikat über die Eigenschaft Dienstzertifikat – Fingerabdruck bereitgestellt werden. Der Standardwert ist None (Kein).
   Certificate	Gibt den Typ der Anmeldeinformationen an, der für die Clientauthentifizierung mit nachrichtenbasierter Sicherheit verwendet werden soll. Gültige Werte sind: - Benutzername: Dieser Sendeport wird beim Dienst mit anmeldeinformationen für UserName authentifiziert. Dies wird für den WCF-BasicHttp-Sendeadapter nicht unterstützt. - Zertifikat: Dieser Sendeport wird bei Diensten mithilfe des Clientzertifikats 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	Geben Sie den Fingerabdruck des X.509-Zertifikats für die Authentifizierung dieses Sendeports gegenüber Diensten 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 Diensts 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. Diese Option ist nur für die Sicherheitskonfiguration gültig, die im folgenden Abschnitt "Unterstützung des Einmaligen Anmeldens für Unternehmen für den WCF-BasicHttp-Sendeadapter" aufgeführt wird. Der Standardwert ist Nicht einmaliges Anmelden verwenden.
   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.

   Unterstützung für den WCF-BasicHttp-Sendeadapter für einzelbetriebige Sign-On Der WCF-BasicHttp Sendeadapter kann ein SSO-Ticket vom SSO-Server einlösen, um die Benutzeranmeldeinformationen nur in den Sicherheitskonfigurationen abzurufen, die in der folgenden Tabelle dargestellt sind.

   Sicherheitsmodus	Typ der Anmeldeinformationen des Transportclients	Certificate
   Transport	Grundlegend	–
   Transport	Digest	–
   TransportCredentialOnly	Grundlegend	–
   TransportCredentialOnly	Digest	–
   Meldung	–	UserName
   TransportWithMessageCredential	–	UserName

6. Konfigurieren Sie im Dialogfeld WCF-BasicHttp-Transporteigenschaften auf der Registerkarte Proxy die Proxyeinstellung für den WCF-BasicHttp Sendeport:

   Option	Aufgabe
   Standardproxyeinstellungn des Handlers verwenden	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 für diesen Sendeport der in der Address-Eigenschaft angegebene Proxyserver verwendet wird. 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 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-BasicHttp-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.

7. Geben Sie im Dialogfeld WCF-BasicHttp-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-Body-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-BasicHttp 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.

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.

1. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Plattformeinstellungen und dann Adapter.

2. Wählen Sie WCF-BasicHttp aus, und doppelklicken Sie dann auf den Sendehandler.

3. Wählen Sie unter Adapterhandlereigenschaften auf der Registerkarte Allgemein die Option Eigenschaften aus.

4. Gehen Sie auf der Registerkarte Proxy wie folgt vor.

   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 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 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.

5. Klicken Sie auf OK , bis Sie alle Dialogfelder beenden.

   Siehe auch

Was sind WCF-Adapter?

SB-Messaging-Adapter

Verwenden von Adaptern