<security> of <netHttpBinding>

Article
09/15/2021

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.

Share via