Bagikan melalui

<message> element of <netTcpBinding>

  • Artikel

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.

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.

See Also

Reference

MessageSecurityOverTcp
Message
Message
NetTcpSecurityElement

Concepts

<binding>

Other Resources

Securing Services and Clients
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients


© 2007 Microsoft Corporation. All rights reserved.
Last Published: 2010-01-05