-
Publish the BizTalk project by running the BizTalk WCF Service Publishing Wizard.
-
If you did not select the Create BizTalk receive locations option in the following figure when creating the WCF service, create a new receive port and receive location for the published WCF service, and then select the WCF adapter for the transport type that the receive location will use. You must select the same WCF adapter as is selected on the WCF Service Type page shown in the following figure. For more information about creating a receive location, see How to Create a Receive Location.
Note |
|---|
|
The BizTalk WCF Service Publishing Wizard creates a binding file, BindingInfo.xml, in the \App_Data\Temp folder in the Web directory for the published WCF service (.svc file). If you select the Create BizTalk receive locations option, the wizard uses the binding file to create the receive location. In the BizTalk Server Administration console, you can import this binding file to create the receive location manually. For more information about importing a binding file, see Importing Bindings.
|
-
If necessary, open the BizTalk Server Administration console as follows: Click Start, point to Programs, point to Microsoft BizTalk Server 2006, and then click BizTalk Server Administration.
-
In the console tree, expand BizTalk Server 2006 Administration, expand BizTalk Group, expand Applications, expand the application where the generated WCF service should be placed, expand Receive Locations, and then double-click the receive location for the WCF service.
-
In the Receive Location Properties dialog box, click Configure.
-
If the receive location hosts the WCF-BasicHttp or WCF-WSHttp adapter, in the Transport Properties dialog box, click the Security tab, and then configure the security properties on the tab. If the receive location hosts the WCF-CustomIsolated adapter, in the Transport Properties dialog box, click the Binding tab, and then configure the binding information on the tab.
.gif)
Note |
|---|
|
The transport client credential type property for the isolated WCF adapter must match the authentication scheme of the Internet Information Services (IIS) virtual directory hosting this receive location. For example, if the property is set to Windows, you also need to enable Integrated Windows authentication for the virtual directory that hosts this receive location. Similarly if the property is set to None, you must allow anonymous access to the virtual directory that hosts this receive location. For more information about how to configure the security properties for the WCF-BasicHttp and WCF-WSHttp adapters, see How to Configure a WCF-BasicHttp Receive Location, and How to Configure a WCF-WSHttp Receive Location. For more information about how to configure the binding information, see How to Configure a WCF-CustomIsolated Receive Location.
|
-
If you did not select the Create BizTalk receive locations option when creating the WCF services, in the Transport Properties dialog box, click the General tab. On the General tab, type the URI for this receive location in the Address text box. Specify the virtual directory plus the .svc file name that the BizTalk WCF Service Publishing Wizard generated in the previous procedure—for example, /path/service.svc.
Note |
|---|
|
The Address property should start with a forward slash ("/") and end in ".svc". The Address property must not contain a protocol scheme, computer name, or port number such as http://host:port. Only the virtual directory path can be used for the property. The WCF service markup file must have an .svc extension.
|
-
If you selected Transport or TransportWithMessageCredential in the Security mode drop-down list on the Security tab for the WCF-BasicHttp and WCF-WSHttp adapters, you must set up Secure Sockets Layer (SSL) in IIS. For more information see "How to Implement SSL in IIS" at http://go.microsoft.com/fwlink/?LinkId=74560. If you set the Transport or TransportWithMessageCredential security mode in the binding information for the WCF-CustomIsolated adapter, you must also set up SSL in IIS
-
If the receive location hosts the WCF-BasicHttp or WCF-WSHttp adapter, in the Transport Properties dialog box, configure the General, Binding, and Messages tabs if necessary. If the receive location hosts the WCF-CustomIsolated adapter, configure the General, Behavior, Other, and Messages tabs for your purpose. For the WCF-CustomIsolated adapter, you can import the Address (URI) and Endpoint Identity properties on the General tab, binding information on the Binding tab, and behaviors on the Behavior tab for this receive location from a configuration file.
-
Enable the receive location for the published WCF service by using the BizTalk Server Administration console. For more information about how to enable the receive location, see How to Enable a Receive Location.
Note |
|---|
|
The receive locations are disabled when they are created. After creating receive locations with the BizTalk Server WCF Service Wizard, you must enable the receive locations.
|
-
Configure the IIS application pool to host the receive location for the published WCF service by using the IIS Management console. For more information about how to configure the application pool for the isolated WCF adapters, see Configuring IIS for the Isolated WCF Receive Adapters.
-
Open a command prompt, go to the folder where the BizTalk Server WCF Service Publishing Wizard created the WCF service in %SystemDrive%\InetPub\, and then open the Web.config file using Notepad.
-
In Notepad, add the following line inside the <system.web> element:
<trust level="Full" originUrl="" />
Note |
|---|
|
This setting is optional and it grants the ASP.NET application hosting the published WCF service access to any resource that is subject to operating system security. This is the trust level that WCF requires when you have Windows SharePoint Services installed and running on the same machine with the published WCF services.
|
-
In Internet Explorer, in the Address box, type the URL for the WCF service using the format http://host[:port]/apppath/wcfservicename.svc to test the published WCF service. The parameters are described in the following table.
|
Parameter
|
Value
|
|---|
|
host[:port]
|
The name of the computer where you have deployed your WCF service. A colon and the port number can follow this server name.
|
|
apppath
|
The name of your virtual directory and the Web application path.
|
|
wcfservicename.svc
|
The name of the WCF service .svc file.
|
-
To prevent unintentional disclosure of potentially sensitive service metadata, it is recommended to disable this behavior on the production environment by performing the following tasks:
-
In Notepad, open Web.config in the folder where the BizTalk Server WCF Service Publishing Wizard created the WCF service in %SystemDrive%\InetPub\.
-
In Notepad, set the the httpGetEnabled attribute in the <serviceMetadata> element to false as following line:
<serviceMetadata httpGetEnabled="false" httpsGetEnabled="false" />