Konfigurieren von WCF-Diensten, die mit dem Assistenten für BizTalk WCF-Dienstpublishing veröffentlicht wurden

Nachdem Sie die WCF-Dienste mit dem Assistenten für BizTalk WCF-Dienstpublishing veröffentlicht haben, müssen Sie sie ordnungsgemäß konfigurieren. In diesem Thema wird das Konfigurieren der veröffentlichten WCF-Dienste beschrieben.

Hinweis

Sie müssen Ihre BizTalk-Projekte erstellen und durch Ausführung des Assistenten für BizTalk WCF-Dienstpublishing veröffentlichen. Weitere Informationen zur Verwendung des BizTalk WCF-Dienstveröffentlichungs-Assistenten finden Sie unter Verwenden des BizTalk WCF-Dienstveröffentlichungs-Assistenten zum Veröffentlichen von Orchestrierungen als WCF-Dienste und Verwenden des BizTalk WCF-Dienstveröffentlichungs-Assistenten zum Veröffentlichen von Schemas als WCF-Dienste.

So konfigurieren Sie die Empfangsspeicherorte für einen veröffentlichten WCF-Dienst

1. Veröffentlichen Sie das BizTalk-Projekt, indem Sie den Assistenten für BizTalk WCF-Dienstpublishing ausführen.

2. Wenn Sie beim Erstellen des WCF-Diensts nicht die Option BizTalk-Empfangsspeicherorte erstellen in der folgenden Abbildung ausgewählt haben, erstellen Sie einen neuen Empfangsport und einen neuen Empfangsspeicherort für den veröffentlichten WCF-Dienst, und wählen Sie dann den WCF-Adapter für den Transporttyp aus, den der Empfangsspeicherort verwenden soll. Sie müssen denselben WCF-Adapter auswählen, der auf der Seite WCF-Diensttyp in der folgenden Abbildung ausgewählt ist. Weitere Informationen zum Erstellen eines Empfangsspeicherorts finden Sie unter Erstellen eines Empfangsspeicherorts.

   Hinweis

   Der Assistent für BizTalk WCF-Dienstpublishing erstellt eine Bindungsdatei, BindingInfo.xml, im Ordner \App_Data\Temp des Webverzeichnisses für den veröffentlichten WCF-Dienst (SVC-Datei). Wenn Sie die Option BizTalk-Empfangsspeicherorte erstellen auswählen, verwendet der Assistent die Bindungsdatei, um den Empfangsspeicherort zu erstellen. In der BizTalk Server-Verwaltungskonsole können Sie diese Bindungsdatei importieren, um den Empfangsspeicherort manuell zu erstellen. Weitere Informationen zum Importieren einer Bindungsdatei finden Sie unter Importieren von Bindungen.

   

3. Öffnen Sie ggf. die BizTalk Server Verwaltungskonsole wie folgt: Klicken Sie auf Start, zeigen Sie auf Programme, zeigen Sie auf Microsoft BizTalk Server, und klicken Sie dann auf BizTalk Server Verwaltung.

4. Erweitern Sie in der Konsolenstruktur BizTalk Server Verwaltung, BizTalk-Gruppe, Anwendungen, erweitern Sie die Anwendung, in der der generierte WCF-Dienst platziert werden soll, erweitern Sie Empfangsspeicherorte, und doppelklicken Sie dann auf den Empfangsspeicherort für den WCF-Dienst.

5. Klicken Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts auf Konfigurieren.

6. Wenn der Empfangsspeicherort den WCF-BasicHttp- oder WCF-WSHttp-Adapter hostet, klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Sicherheit , und konfigurieren Sie dann die Sicherheitseigenschaften auf der Registerkarte. Wenn der Empfangsspeicherort den WCF-CustomIsolated Adapter hostet, klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Bindung , und konfigurieren Sie dann die Bindungsinformationen auf der Registerkarte.

   

   Hinweis

   Die Eigenschaft Typ der Anmeldeinformationen des Transportclients für den isolierten WCF-Adapter muss zum Authentifizierungsschema des virtuellen IIS-Verzeichnisses (Internet Information Services, Internetinformationsdienste) passen, das als Host für diesen Empfangsspeicherort dient. Wenn die Eigenschaft beispielsweise auf Windows festgelegt ist, müssen Sie auch Integrierte Windows-Authentifizierung für das virtuelle Verzeichnis aktivieren, das diesen Empfangsspeicherort hostet. Entsprechend muss anonymer Zugriff auf das als Host für den Empfangsspeicherort dienende virtuelle Verzeichnis zugelassen werden, wenn die Eigenschaft auf Keinefestgelegt ist. Weitere Informationen zum Konfigurieren der Sicherheitseigenschaften für die WCF-BasicHttp- und WCF-WSHttp-Adapter finden Sie unter WCF-BasicHttp Adapter und Konfigurieren eines WCF-WSHttp Empfangsspeicherorts. Weitere Informationen zum Konfigurieren der Bindungsinformationen finden Sie unter Konfigurieren eines WCF-CustomIsolated Empfangsspeicherorts.

7. Wenn Sie beim Erstellen der WCF-Dienste nicht die Option BizTalk-Empfangsspeicherorte erstellen ausgewählt haben, klicken Sie im Dialogfeld Transporteigenschaften auf die Registerkarte Allgemein . Geben Sie auf der Registerkarte Allgemein den URI für diesen Empfangsspeicherort in das Textfeld Adresse ein. Geben Sie das virtuelle Verzeichnis und den Namen der SVC-Datei an, die der BizTalk WCF-Dienstveröffentlichungs-Assistent im vorherigen Verfahren generiert hat. Geben Sie beispielsweise /path/service.svc ein.

   Hinweis

   Die Address-Eigenschaft sollte mit einem Schrägstrich ("/") beginnen und auf ".svc" enden. Die Address-Eigenschaft darf kein Protokollschema, keinen Computernamen oder keine Portnummer wie http://host:port. Es kann nur der virtuelle Verzeichnispfad für die Eigenschaft verwendet werden. Die Markupdatei für den WCF-Dienst muss die Erweiterung .svc haben.

   

8. Wenn Sie transport oderTransportWithMessageCredential in der Dropdownliste Sicherheitsmodus auf der Registerkarte Sicherheit für die WCF-BasicHttp- und WCF-WSHttp-Adapter ausgewählt haben, müssen Sie SSL (Secure Sockets Layer) in IIS einrichten. Wenn Sie den Sicherheitsmodus Transport oder TransportWithMessageCredential in den Bindungsinformationen für den WCF-CustomIsolated-Adapter festlegen, müssen Sie SSL auch in IIS einrichten.

9. Wenn der Empfangsspeicherort den WCF-BasicHttp- oder WCF-WSHttp-Adapter hostet, konfigurieren Sie im Dialogfeld Transporteigenschaften bei Bedarf die Registerkarten Allgemein, Bindung und Nachrichten . Wenn der Empfangsspeicherort den WCF-CustomIsolated-Adapter hostet, konfigurieren Sie die Registerkarten Allgemein, Verhalten, Andere und Nachrichten für Ihren Zweck. Für den WCF-CustomIsolated-Adapter können Sie die Eigenschaften Adresse (URI) und Endpunktidentität auf der Registerkarte Allgemein , Bindungsinformationen auf der Registerkarte Bindung und Verhalten auf der Registerkarte Verhalten für diesen Empfangsspeicherort aus einer Konfigurationsdatei importieren.

10. Aktivieren Sie den Empfangsspeicherort für den veröffentlichten WCF-Dienst über die BizTalk Server-Verwaltungskonsole. Weitere Informationen zum Aktivieren des Empfangsspeicherorts finden Sie unter Aktivieren eines Empfangsspeicherorts.

    Hinweis

    Die Empfangsspeicherorte sind bei ihrer Erstellung deaktiviert. Nachdem Sie Empfangsspeicherorte mit dem Assistenten für den BizTalk Server WCF-Dienst erstellt haben, müssen Sie sie aktivieren.

11. Konfigurieren Sie den IIS-Anwendungspool zum Hosten des Empfangsspeicherorts für den veröffentlichten WCF-Dienst über die IIS-Verwaltungskonsole. Weitere Informationen zum Konfigurieren des Anwendungspools für die isolierten WCF-Adapter finden Sie unter Konfigurieren von IIS für isolierte WCF-Empfangsadapter.

12. Öffnen Sie eine Eingabeaufforderung, wechseln Sie in %SystemDrive%\InetPub\ zu dem Ordner, in dem der Assistent für BizTalk WCF-Dienstpublishing den WCF-Dienst erstellt hat, und öffnen Sie anschließend in Editor die Datei Web.config.

13. Fügen Sie in Editor die folgende Zeile dem <system.web-Element> hinzu:

    <trust level="Full" originUrl="" />
    

    Hinweis

    Diese Einstellung ist optional und gewährt der ASP.NET-Anwendung, die als Host des veröffentlichten WCF-Diensts dient, Zugriff auf alle Ressourcen, die den Sicherheitseinstellungen des Betriebssystems unterliegen. Dies ist die Vertrauensebene, die WCF erfordert, wenn Windows SharePoint Services auf demselben Computer wie die veröffentlichten WCF-Dienste installiert ist und ausgeführt wird.

14. Geben Sie in Internet Explorer im Feld Adresse die URL für den WCF-Dienst im Format http:// host[:p ort]/apppath/wcfservicename.svc ein, um den veröffentlichten WCF-Dienst zu testen. Die Parameter werden in der folgenden Tabelle beschrieben.

    Parameter	Wert
    host[:p ort]	Der Name des Computers, auf dem Sie Ihren WCF-Dienst bereitgestellt haben. Auf diesen Servernamen können ein Doppelpunkt und die Portnummer folgen.
    apppath	Der Name Ihres virtuellen Verzeichnisses und der Webanwendungspfad.
    WCFDienstname.svc	Der Name der SVC-Datei des WCF-Diensts.

15. Um ein unbeabsichtigtes Offenlegen möglicherweise sensibler Dienstmetadaten zu verhindern, sollte dieses Verhalten in der Produktionsumgebung über die folgenden Schritte deaktiviert werden:

    1. Öffnen Sie in Editor in %SystemDrive%\InetPub\ in dem Ordner, in dem der Assistent für BizTalk Server WCF-Dienstpublishing den WCF-Dienst erstellt hat, die Datei Web.config.

    2. Legen Sie in Editor das httpGetEnabled-Attribut im <serviceMetadata-Element> auf false fest:

       <serviceMetadata httpGetEnabled="false" httpsGetEnabled="false" />
       

Weitere Informationen

Konfigurieren des WCF-BasicHttp-AdaptersKonfigurieren des WCF-WSHttp-AdaptersKonfigurieren des WCF-CustomIsolated-Adapters Konfigurieren derIIS-Websiteauthentifizierung in Windows Server 2003