Teilen über

Aktivieren der WCF-Erweiterbarkeitspunkte mit den WCF-Adaptern

  • Artikel

Aktivieren Sie drei WCF-Erweiterbarkeitspunkte – Verhaltenserweiterung, Bindungselementerweiterung und Bindungserweiterung – mit den adaptern WCF-Custom und WCF-CustomIsolated. Dazu installieren Sie zunächst die Assemblys, die die WCF-Erweiterbarkeitspunkte im globalen Assemblycache (GAC) implementieren, ändern dann die machine.config datei auf Ihren Computern und konfigurieren dann den WCF-Custom oder den WCF-CustomIsolated-Adapter mithilfe der BizTalk Server-Verwaltungskonsole.

Weitere Informationen zu WCF-Erweiterbarkeitspunkten finden Sie unter Erweitern von WCF .

Voraussetzungen

Melden Sie sich mit einem Konto an, das Mitglied der Gruppe BizTalk Server Administratoren ist. Berechtigungen, die für das Bereitstellen und Verwalten einer BizTalk-Anwendung erforderlich sind , enthält weitere Informationen.

Installieren von Assemblys, die einen WCF-Erweiterbarkeitspunkt im GAC implementieren

  1. Kopieren Sie die Assemblys, die die WCF-Erweiterbarkeit implementieren, in einen Ordner auf Ihrem lokalen Computer.

  2. Kopieren Sie die Assemblys, die der WCF-Erweiterbarkeitspunkt verwendet, sofern vorhanden, in einen Ordner auf Ihrem lokalen Computer.

  3. Starten Sie die Visual Studio-Eingabeaufforderung.

  4. Geben Sie folgenden Befehl ein:

    gacutil.exe /if "<Pfad zur Assembly-.dll-Datei>"

  5. Dadurch wird die Assembly im GAC installiert, wobei eine bereits vorhandene Assembly mit demselben Namen überschrieben wird.

  6. Wiederholen Sie an der Visual Studio-Eingabeaufforderung die Schritte 4 und 5 für alle Assemblys, die Sie in den Schritten 1 und 2 dieses Verfahrens kopiert haben.

  7. Wenn Sie über mehrere BizTalk Server Laufzeitcomputer und Verwaltungscomputer verfügen, wiederholen Sie die Schritte 1 bis 6 dieses Verfahrens auf allen Computern.

    Hinweis

    Zum Aktivieren der WCF-Erweiterbarkeitspunkte für die WCF-Adapter muss die BizTalk-Hostinstanz, die den Adapter ausführt, zur Laufzeit die Assemblys laden können, in denen die WCF-Erweiterbarkeitspunkte implementiert werden.

Konfigurieren der machine.config datei für eine WCF-Bindungserweiterung

  1. Wechseln Sie an einer Eingabeaufforderung zu %FrameworkDir%\v4. Ordner X.XXXXX\CONFIG, und öffnen Sie dann die dateimachine.config mithilfe von Editor.

  2. Wenn die machine.config-Datei nicht über die <Elemente system.serverModel>\<extensions> verfügt, fügen Sie diese Elemente im <Konfigurationselement> der machine.config-Datei hinzu, und fügen Sie dann das <bindingExtensions-Element> für eine WCF-Bindungserweiterung innerhalb der <elemente system.serverModel>\<extensions> hinzu. Um beispielsweise die benutzerdefinierte Bindungserweiterung netHttpBinding zu aktivieren, fügen Sie den folgenden Code innerhalb des <Konfigurationselements> der machine.config-Datei hinzu:

    <system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
      <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" />  
    </bindingExtensions>        
  </extensions>  
</system.serviceModel>

    Hinweis

    • Die Informationen für die zu registrierenden Assemblys finden Sie mithilfe des Befehls gacutil /lr<assembly_name>.
    • Weitere Informationen finden Sie unter bindingExtensions zu diesem Element.

  3. Speichern Sie in Editor die Datei machine.config.

  4. Wenn Sie über mehrere BizTalk Server Laufzeitcomputer und Verwaltungscomputer verfügen, wiederholen Sie die Schritte 1 bis 3 dieses Verfahrens auf allen Computern.

    Hinweis

    Sie müssen diese Schritte auf allen Computern für die WCF-Infrastruktur wiederholen, um den WCF-Erweiterbarkeitspunkt für den BizTalk-Host instance und die BizTalk Server Verwaltungskonsole zu verarbeiten.

Konfigurieren einer WCF-Bindungserweiterung mithilfe der BizTalk-Verwaltungskonsole

  1. Öffnen Sie BizTalk Server Administration.

    Hinweis

    Wenn die BizTalk Server-Verwaltungskonsole bereits geöffnet ist, starten Sie die BizTalk Server-Verwaltungskonsole neu.

  2. Wenn Sie den WCF-Custom-Adapter verwenden, erweitern Sie in der BizTalk Server-Verwaltungskonsole Plattformeinstellungen, erweitern Sie Hostinstanzen, und starten Sie dann den BizTalk-Host neu, instance den Adapter ausführt.

  3. Starten Sie bei Verwenden des WCF-CustomIsolated-Adapters in der Verwaltungskonsole von Internetinformationsdienste den Anwendungspool neu, der dem WCF-Empfangsspeicherort zugeordnet ist.

  4. Wenn Sie einen Empfangsspeicherort für die Verwendung eines WCF-Erweiterbarkeitspunkts konfigurieren möchten, erweitern Sie in der BizTalk Server Verwaltungskonsole bizTalk-Gruppe, erweitern <Sie BizTalk-Anwendung>, erweitern Sie Empfangsspeicherorte, und doppelklicken Sie dann im rechten Bereich auf <Empfangsspeicherort>.

    • Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts in der Dropdownliste Typ die Option WCF-Custom oder WCF-CustomIsolated je nach WCF-Adapter , den Sie verwenden möchten, aus, und klicken Sie dann auf Konfigurieren.

  5. Wenn Sie einen Sendeport für die Verwendung eines WCF-Erweiterbarkeitspunkts konfigurieren möchten, erweitern Sie in der BizTalk Server Verwaltungskonsole die Option BizTalk-Gruppe, BizTalk-Anwendung<>, Sendeports, und doppelklicken Sie dann im rechten Bereich auf <Port> senden.

    • Wählen Sie im Dialogfeld Porteigenschaften senden in der Dropdownliste Typ die Option WCF-Custom aus, und klicken Sie dann auf Konfigurieren.

  6. Wählen Sie im Dialogfeld Transporteigenschaften auf der Registerkarte Bindung die Bindungserweiterung aus, und konfigurieren Sie dann die restlichen Einstellungen für den Transport.

  7. Schließen Sie in der BizTalk Server Verwaltungskonsole alle geöffneten Dialogfelder, indem Sie auf die Schaltflächen OK klicken, und stellen Sie sicher, dass keine Fehlermeldungen und fehlerhafte Ereignisprotokolle angezeigt werden.

Konfigurieren der machine.config-Datei für eine WCF-Bindungselementerweiterung

  1. Wechseln Sie an einer Eingabeaufforderung zu %FrameworkDir%\v4. Ordner X.XXXXX\CONFIG, und öffnen Sie dann die dateimachine.config mithilfe von Editor.

  2. Wenn die machine.config-Datei nicht über die <Elemente system.serverModel>\<extensions> verfügt, fügen Sie diese Elemente im <Konfigurationselement> der machine.config-Datei hinzu, und fügen Sie dann das <bindingElementExtensions-Element> für eine WCF-Bindungselementerweiterung innerhalb der <elemente system.serverModel>\<extensions> hinzu. Um beispielsweise eine benutzerdefinierte Bindungselementerweiterung (dropInterceptor) zu aktivieren, fügen Sie den folgenden Code innerhalb des <Konfigurationselements> der machine.config-Datei hinzu:

    <system.serviceModel>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/>  
    </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>

    Hinweis

    • Die Informationen für die zu registrierenden Assemblys finden Sie mithilfe des Befehls gacutil /lr<assembly_name>.
    • Weitere Informationen finden Sie unter bindingElementExtensions für dieses Element.

  3. Speichern Sie in Editor die Datei machine.config.

  4. Wenn Sie über mehrere BizTalk Server Laufzeitcomputer und Verwaltungscomputer verfügen, wiederholen Sie die Schritte 1 bis 3 dieses Verfahrens auf allen Computern.

    Hinweis

    Sie müssen diese Schritte auf allen Computern für die WCF-Infrastruktur wiederholen, um den WCF-Erweiterbarkeitspunkt für den BizTalk-Host instance und die BizTalk Server Verwaltungskonsole zu verarbeiten.

Konfigurieren einer WCF-Bindungselementerweiterung mithilfe der BizTalk-Verwaltungskonsole

  1. Öffnen Sie BizTalk Server Administration.

    Hinweis

    Wenn die BizTalk Server-Verwaltungskonsole bereits geöffnet ist, starten Sie die BizTalk Server-Verwaltungskonsole neu.

  2. Wenn Sie den WCF-Custom-Adapter verwenden, erweitern Sie in der BizTalk Server-Verwaltungskonsole Plattformeinstellungen, erweitern Sie Hostinstanzen, und starten Sie dann den BizTalk-Host neu, instance den Adapter ausführt.

  3. Starten Sie bei Verwenden des WCF-CustomIsolated-Adapters in der Verwaltungskonsole von Internetinformationsdienste den Anwendungspool neu, der dem WCF-Empfangsspeicherort zugeordnet ist.

  4. Wenn Sie einen Empfangsspeicherort für die Verwendung eines WCF-Erweiterbarkeitspunkts konfigurieren möchten, erweitern Sie in der BizTalk Server Verwaltungskonsole bizTalk-Gruppe, erweitern <Sie BizTalk-Anwendung>, erweitern Sie Empfangsspeicherorte, und doppelklicken Sie dann im rechten Bereich auf <Empfangsspeicherort>.

    • Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts in der Dropdownliste Typ die Option WCF-Custom oder WCF-CustomIsolated je nach WCF-Adapter , den Sie verwenden möchten, aus, und klicken Sie dann auf Konfigurieren.

  5. Wenn Sie einen Sendeport für die Verwendung eines WCF-Erweiterbarkeitspunkts konfigurieren möchten, erweitern Sie in der BizTalk Server Verwaltungskonsole die Option BizTalk-Gruppe, BizTalk-Anwendung<>, Sendeports, und doppelklicken Sie dann im rechten Bereich auf <Port> senden.

    • Wählen Sie im Dialogfeld Porteigenschaften senden in der Dropdownliste Typ die Option WCF-Custom aus, und klicken Sie dann auf Konfigurieren.

  6. Wählen Sie im Dialogfeld Transporteigenschaften auf der Registerkarte Bindung in der Dropdownliste Bindungstyp die Option customBinding aus.

  7. Klicken Sie im Dialogfeld Transporteigenschaften auf der Registerkarte Bindung mit der rechten Maustaste auf den Clientbereich der Liste Bindung , und klicken Sie dann auf Erweiterung hinzufügen.

  8. Wählen Sie im Dialogfeld Bindungselementerweiterung auswählen eine Bindungselementerweiterung aus, und klicken Sie dann auf OK.

  9. Passen Sie im Dialogfeld Transporteigenschaften auf der Registerkarte Bindung die Reihenfolge der Bindungselemente an, die in der Bindungsliste hinzugefügt wurden, abhängig vom Typ der Bindungselementerweiterung, die Sie im vorherigen Schritt hinzugefügt haben, wie folgt:

    • Klicken Sie in der Liste Bindung mit der rechten Maustaste auf eine Bindungselementerweiterung, und klicken Sie dann auf Erweiterung nach oben oder Erweiterung nach unten verschieben. Die niedrigste Bindungselementerweiterung in der Bindungsliste entspricht der unteren Komponente des Kanalstapels. Das höchste Bindungselement in der Bindungsliste entspricht der obersten Komponente des Kommunikationsstapels.

      Hinweis

      Ausführliche Informationen zur spezifischen Reihenfolge der Bindungselemente für die benutzerdefinierte Bindung finden Sie unter Benutzerdefinierte Bindungen.

  10. Konfigurieren Sie im Dialogfeld mit den Transporteigenschaften die restlichen Einstellungen für den Transport.

  11. Schließen Sie in der BizTalk Server Verwaltungskonsole alle geöffneten Dialogfelder, indem Sie auf die Schaltflächen OK klicken, und stellen Sie sicher, dass keine Fehlermeldungen und fehlerhafte Ereignisprotokolle angezeigt werden.

Konfigurieren der machine.config-Datei für eine WCF-Verhaltenserweiterung

  1. Wechseln Sie an einer Eingabeaufforderung zu %FrameworkDir%\v4. Ordner X.XXXXX\CONFIG, und öffnen Sie dann die dateimachine.config mithilfe von Editor.

  2. Wenn die machine.config-Datei nicht über die <Elemente system.serverModel>\<extensions> verfügt, fügen Sie diese Elemente im <Konfigurationselement> der machine.config-Datei hinzu, und fügen Sie dann das <behaviorExtensions-Element> für eine WCF-Verhaltenserweiterung innerhalb der <Elemente system.serverModel>\<extensions> hinzu. Um beispielsweise eine benutzerdefinierte Verhaltenserweiterung zu aktivieren, schemaValidator, fügen Sie den folgenden Code innerhalb des <Konfigurationselements> der machine.config-Datei hinzu:

    <system.serviceModel>  
  <extensions>  
    <behaviorExtensions>  
      <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/>  
    </behaviorExtensions>  
  </extensions>  
</system.serviceModel>

    Hinweis

    • Die Informationen für die zu registrierenden Assemblys finden Sie mithilfe des Befehls gacutil /lr<assembly_name>.
    • Weitere Informationen finden Sie unter behaviorExtensions für dieses Element.

  3. Speichern Sie in Editor die Datei machine.config.

  4. Wenn Sie über mehrere BizTalk Server Laufzeitcomputer und Verwaltungscomputer verfügen, wiederholen Sie die Schritte 1 bis 3 dieses Verfahrens auf allen Computern.

    Hinweis

    Sie müssen diese Schritte auf allen Computern für die WCF-Infrastruktur wiederholen, um den WCF-Erweiterbarkeitspunkt für den BizTalk-Host instance und die BizTalk Server Verwaltungskonsole zu verarbeiten.

Konfigurieren einer WCF-Verhaltenserweiterung mithilfe der BizTalk-Verwaltungskonsole

  1. Öffnen Sie BizTalk Server Administration.

    Hinweis

    Wenn die BizTalk Server-Verwaltungskonsole bereits geöffnet ist, starten Sie die BizTalk Server-Verwaltungskonsole neu.

  2. Wenn Sie den WCF-Custom-Adapter verwenden, erweitern Sie in der BizTalk Server-Verwaltungskonsole Plattformeinstellungen, erweitern Sie Hostinstanzen, und starten Sie dann den BizTalk-Host neu, instance den Adapter ausführt.

  3. Starten Sie bei Verwenden des WCF-CustomIsolated-Adapters in der Verwaltungskonsole von Internetinformationsdienste den Anwendungspool neu, der dem WCF-Empfangsspeicherort zugeordnet ist.

  4. Wenn Sie einen Empfangsspeicherort für die Verwendung eines WCF-Erweiterbarkeitspunkts konfigurieren möchten, erweitern Sie in der BizTalk-Verwaltungskonsole bizTalk-Gruppe, erweitern <Sie BizTalk-Anwendung>, erweitern Sie Empfangsspeicherorte, und doppelklicken Sie dann im rechten Bereich auf <Empfangsspeicherort>.

    • Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts in der Dropdownliste Typ die Option WCF-Custom oder WCF-CustomIsolated je nach WCF-Adapter , den Sie verwenden möchten, aus, und klicken Sie dann auf Konfigurieren.

  5. Wenn Sie einen Sendeport für die Verwendung eines WCF-Erweiterbarkeitspunkts konfigurieren möchten, erweitern Sie in der BizTalk-Verwaltungskonsole die Option BizTalk-Gruppe, BizTalk-Anwendung<>, Sendeports, und doppelklicken Sie dann im rechten Bereich auf <Port> senden.

    • Wählen Sie im Dialogfeld Porteigenschaften senden in der Dropdownliste Typ die Option WCF-Custom aus, und klicken Sie dann auf Konfigurieren.

  6. Klicken Sie im Dialogfeld Transporteigenschaften auf der Registerkarte Verhalten mit der rechten Maustaste auf ServiceBehavior oder EndpointBehavior , je nach Typ der Verhaltenserweiterung, und wählen Sie dann im Dialogfeld Verhaltenserweiterung auswählen die Verhaltenserweiterung aus, und klicken Sie dann auf OK.

  7. Konfigurieren Sie im Dialogfeld mit den Transporteigenschaften die restlichen Einstellungen für den Transport.

  8. Schließen Sie in der BizTalk Server Verwaltungskonsole alle geöffneten Dialogfelder, indem Sie auf die Schaltflächen OK klicken, und stellen Sie sicher, dass keine Fehlermeldungen und fehlerhafte Ereignisprotokolle angezeigt werden.

Konfigurieren eines WCF-Custom Empfangsspeicherorts mit einem SSL-Zertifikat

  • Wenn ein WCF-Custom Empfangsspeicherort den HTTP-Kernelmodustreiber (HTTP.sys) verwendet, z. B. das httpsTransport-Bindungselement , für die SSL-Kommunikation (Secure Sockets Layer) muss für den Empfangsspeicherort ein Zertifikat für jeden Socket (Kombination aus IP-Adresse/Port) registriert sein. Binden Sie mit dem Programm HttpCfg.exe ein SSL-Zertifikat an einen Port auf dem Computer. Weitere Informationen finden Sie unter Vorgehensweise: Konfigurieren eines Ports mit einem SSL-Zertifikat.