<message> element of <netTcpBinding>

Article
01/05/2010

Defines the type of message-level security requirements for an endpoint configured with the <netTcpBinding>.

Schema Hierarchy

<system.serviceModel>
  <binding>
    <netTcpBinding>
      <binding>
        <security> of <netTcpBinding>
          <message> element of <netTcpBinding>

Syntax

<message 
      algorithmSuite=System.Servicemodel.Security.SecurityAlgorithmsuite
    clientCredentialType="None/Windows/UserName/Certificate/IssuedToken"/>

Attributes and Elements

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

Attributes

Attribute	Description
algorithmSuite	Sets the message encryption and key-wrap algorithms. The algorithms and the key sizes are determined by the SecurityAlgorithmSuite class. These algorithms map to those specified in the Security Policy Language (WS-SecurityPolicy) specification. Possible values are shown in the following table. The default value is Basic256. If the service binding specifies an algorithmSuite value that is not equal to the default, and you generate the configuration file using Svcutil.exe, then it is not generated correctly, and you must manually edit the configuration file to set this attribute to the desired value.
clientCredentialType	Specifies the type of credential to be used when performing client authentication using Message-based security. Possible values are shown in the following table. The default value is UserName. This attribute is of type MessageCredentialType.

algorithmSuite

Sets the message encryption and key-wrap algorithms. The algorithms and the key sizes are determined by the SecurityAlgorithmSuite class. These algorithms map to those specified in the Security Policy Language (WS-SecurityPolicy) specification.

Possible values are shown in the following table. The default value is Basic256.

If the service binding specifies an algorithmSuite value that is not equal to the default, and you generate the configuration file using Svcutil.exe, then it is not generated correctly, and you must manually edit the configuration file to set this attribute to the desired value.

clientCredentialType

Specifies the type of credential to be used when performing client authentication using Message-based security. Possible values are shown in the following table. The default value is UserName. This attribute is of type MessageCredentialType.

Child Elements

None

Parent Elements

Element	Description
<security> of <netTcpBinding>	Defines the security capabilities for the NetTcpBindingElement.

Remarks

Message uses message-level security for the integrity and confidentiality of the SOAP message, and for mutual authentication of the communication peers. If this security mode is selected on a binding, the channel stack is configured with message security binding elements and the SOAP messages are secured in compliance with WS-Security* standards.

<message> element of <netTcpBinding>

Schema Hierarchy

Syntax

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

See Also

Reference

Concepts

Other Resources

Additional resources