<security> of <netHttpBinding>

Defines the security capabilities of the <netHttpBinding>.

<configuration>
  <system.serviceModel>
    <bindings>
      <netHttpBinding>
        <binding>
          <security>

Syntax

<security mode="Message/None/Transport/TransportWithCredential">
  <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
             proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
             realm="string" />
  <message algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
           clientCredentialType="Certificate/IssuedToken/None/UserName/Windows" />
</security>

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
mode Optional. Specifies the type of security that is used. The default is None. This attribute is of type BasicHttpSecurityMode.

mode attribute

Value Description
None - Messages are not secured during transfer.
Transport Security is provided using HTTPS transport. The SOAP messages are secured using HTTPS. The service is authenticated to the client using the service's X.509 certificate. The client is authenticated using the ClientCredentialType supplied.
Message Security is provided using SOAP message security. By default, the body is encrypted and signed. For this binding, the system requires that the server certificate be provided to the client out of band. The only valid ClientCredentialType for this binding is Certificate.
TransportWithMessageCredential Integrity, confidentiality and server authentication are provided by transport security. Client authentication is provided by means of SOAP message security. This mode is relevant when the user is authenticating using username/password and there is an existing HTTP deployment for securing message transfer.
TransportCredentialOnly This mode does not provide message integrity and confidentiality. It provides http-based client authentication. This mode should be used with caution. It should be used in environments where the transport security is being provided by other means (such as IPSec) and only client authentication is provided by the WCF infrastructure.

Child elements

Element Description
<transport> Defines the transport security settings for a basic HTTP service. This element corresponds to HttpTransportSecurity.
<message> Defines the message security settings for a basic HTTP service. This element corresponds to BasicHttpMessageSecurity.

Parent elements

Element Description
binding The binding element of the <basicHttpBinding>.

Remarks

By default, the SOAP message is not secured and the client is not authenticated. This element enables you to configure additional security settings for the netHttpBinding element.

See also