Web Service Binding Types

A binding specifies the protocols, transports, and message encoders used for communication between clients and services.

Basic HTTP binding

This binding uses HTTP as the transport for sending SOAP 1.1 messages. Use the Basic HTTP binding to communicate with services exposing endpoints that conform to WS-I BP 1.1, such as ASMX Web services or Windows Communication Foundation (WCF) services configured with the Basic HTTP binding.

Security is turned off by default, but can be added setting the Mode to a value other than None. It uses a "Text" message encoding and UTF-8 text encoding by default.

General

Name	Description
Allow cookies	Specifies whether the client accepts cookies and propagates them on future requests.
Bypass proxy on local	Specifies whether to bypass the proxy server for local addresses.
Close timeout	The interval of time provided for a connection to close before the transport raises an exception causing the Adapterflow to fail.
Host name comparison mode	Specifies whether the hostname is used to reach the service when matching the URI. The following values are valid for this setting: StrongWildcard (default) – Ignores the hostname when dispatching incoming messages to this endpoint. Exact – Uses the hostname when dispatching incoming messages to this endpoint, if no strong match was found. WeakWildcard – If no strong or exact match was found, ignores the hostname when matching.
Max buffer pool size	The maximum amount of memory that is allocated for use by the manager of the message buffers that receive messages from the channel.
Max buffer size	The maximum size for a buffer that receives messages from the channel.
Max received message size	The maximum size for a message that can be received on a channel configured with this binding.
Message encoding	Specifies whether MTOM or Text is used to encode SOAP messages.
Name	The name of the binding.
Open timeout	The interval of time provided for a connection to open before the transport raises an exception causing the Adapterflow to fail.
Proxy address	The URI address of the HTTP proxy.
Receive timeout	Not used.
Send timeout	The interval of time provided for a write operation to complete before the transport raises an exception causing the Adapterflow to fail.
Transfer mode	Specifies whether messages are sent buffered or streamed.
Use default web proxy	Specifies whether the auto-configured HTTP proxy of the system should be used, if available.

Reader quota properties

Name	Description
Max array length	The maximum allowed array length.
Max bytes per read	The maximum allowed bytes returned for each read.
Max depth	The maximum nested Node depth.
Max name table char count	The maximum number of characters allowed in a table name.
Max string content length	The maximum string length returned by the reader.

Security properties

Name	Description
Client credential type	The credential type that the client can authenticate with when security is enabled. The following value are valid for this setting: UserName – Indicates that the client be authenticated using a username credential. Certificate – Indicates that a client be authenticated using a certificate.
Mode	The security mode. The following value are valid for this setting: None (Default) – The SOAP message is not secured during transfer. Transport – Security is provided using HTTPS. The service must be configured with SSL certificates. The SOAP message is protected as a whole using HTTPS. The service is authenticated by the client using the service’s SSL certificate. The client authentication is controlled through the Client credential type. Message – Security is provided using SOAP message security. The system requires that the server certificate be provided to the client separately. The valid client credential types for this binding are UserName and Certificate. TransportWithMessageCredential – Integrity, confidentiality and server authentication are provided by HTTPS. The service must be configured with a certificate. Client authentication is provided by means of SOAP message security. This mode is applicable when the user is authenticating with a UserName or Certificate credential and there is an existing HTTPS deployment for securing message transfer. TransportCredentialOnly – This mode does not provide message integrity and confidentiality. It provides only HTTP-based client authentication. Use this mode with caution. It should be used in environments where the transfer security is being provided by other means (such as IPSec) and only client authentication is provided by the Windows Communication Foundation (WCF) infrastructure.
Proxy credential type	The valid credential types for HTTP proxy authentication. The following value are valid for this setting: None – Anonymous authentication. Basic – Basic authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication. Digest – Digest authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication Ntlm – NTLM authentication. Windows – Windows authentication.
Realm	The authentication realm for digest or basic authentication.
Security algorithm	The algorithm suite to be used.
Transport client credential type	Valid credential types for HTTP client. The following value are valid for this setting: None – Anonymous authentication. Basic – Basic authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication. Digest – Digest authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication. Ntlm – Client authentication using NTLM. Windows – Client authentication using Windows. Certificate – Client authentication using a certificate.

WS HTTP binding

The WS HTTP binding is similar to the Basic HTTP binding but provides more Web service features. It uses the HTTP transport and provides message security, as does Basic HTTP binding, but it also provides transactions, reliable messaging, and WS-Addressing, either enabled by default or available through a single control setting.

General

Name	Description
Allow cookies	Specifies whether the client accepts cookies and propagates them on future requests.
Bypass proxy on local	Specifies whether to bypass the proxy server for local addresses.
Close timeout	The interval of time provided for a connection to close before the transport raises an exception causing the Adapterflow to fail.
Host name comparison mode	Specifies whether the hostname is used to reach the service when matching the URI. The following values are valid for this setting: StrongWildcard (default) – Ignores the hostname when dispatching incoming messages to this endpoint. Exact – Uses the hostname when dispatching incoming messages to this endpoint, if no strong match was found. WeakWildcard – If no strong or exact match was found, ignores the hostname when matching.
Max buffer pool size	The maximum amount of memory that is allocated for use by the manager of the message buffers that receive messages from the channel.
Max received message size	The maximum size for a message that can be received on a channel configured with this binding.
Message encoding	Specifies whether MTOM or Text is used to encode SOAP messages.
Name	The name of the binding.
Open timeout	The interval of time provided for a connection to open before the transport raises an exception causing the Adapterflow to fail.
Proxy address	The URI address of the HTTP proxy.
Receive timeout	The interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.
Send timeout	The interval of time provided for a write operation to complete before the transport raises an exception causing the Adapterflow to fail.
Text encoding	The character encoding that is used for the message text.
Transaction flow	Specifies whether this binding is to support flowing WS-Transactions.
Use default web proxy	Specifies whether the auto-configured HTTP proxy of the system is to be used, if available.

Reliable session

Name	Description
Enabled	Specifies whether the reliable session is enabled.
In activity timeout	An interval of time that a service can remain inactive before closing.
Ordered	A value that indicates whether message delivery must preserve the order in which messages are sent.

Reader quota properties

Name	Description
Max array length	The maximum allowed array length.
Max bytes per read	The maximum allowed bytes returned for each read.
Max depth	The maximum nested Node depth.
Max name table char count	The maximum number of characters allowed in a table name.
Max string content length	The maximum string length returned by the reader.

Security properties

Name	Description
Client credential type	The credential type required by a binding for authentication. The following value are valid for this setting: None – Anonymous authentication. Windows – Client authentication using Windows. Username – Client authentication using UserName. Certificate – Client authentication using a certificate. IssuedToken – Client authentication using an issued token (not supported).
Establish security context	Specifies whether a security context token is established.
Mode	The security settings for a binding. The following values are valid for this setting: None – Security is disabled. Transport – Security is provided using a secure transport (for example, HTTPS). Message – Security is provided using SOAP message security. TransportWithMessageCredential – A secure transport (for example, TTPS) provides integrity, confidentiality, and authentication while SOAP message security provides client authentication.
Negotiate service credential	Specifies whether the service credential is provisioned at the client out of band or is obtained from the service through a process of negotiation.
Proxy credential type	The valid credential types for HTTP proxy authentication. The following values are valid for this setting: None – Anonymous authentication. Basic – Basic authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication. Digest – Specifies digest authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication Ntlm – NTLM authentication. Windows – Windows authentication.
Security algorithm	The algorithm suite used for security messages at the SOAP level.
Realm	The authentication realm for digest or basic authentication.
Transport client credential type	The type of client credential to be used for authentication. The following values are valid for this setting: None – Anonymous authentication. Basic – Basic authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication. Digest – Digest authentication. For more information, see RFC 2617 – HTTP Authentication: Basic and Digest Authentication. Ntlm – Client authentication using NTLM. Windows – Client authentication using Windows. Certificate – Client authentication using a certificate.

Custom binding

Custom binding is defined by a list of binding elements, or from the values of another binding. It can only be configured using code expression.

See also

Binding using code expressions