Share via

<security> of <netTcpBinding>

  • Article

Defines the security settings for a binding.

<system.serviceModel>

  <binding>

    <netTcpBinding>

      <binding>

        <security> of <netTcpBinding>

                                    
                                    <netTcpBinding>
                                
                                    
                                       <binding>
                                
                                    
                                          <security mode="None/Transport/Message/TransportWithMessageCredential">
                                
                                    
                                                <message clientCredentialType="None/Windows/UserName/Certificate/InfoCard"
                                
                                    
                                                    defaultProtectionLevel="none/sign/EncryptAndSign" 
                                
                                    
                                                    algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/Rsa15Aes256" />
                                
                                    
                                                <transport clientCredentialType="None/Windows/Certificate"
                                
                                    
                                                    protectionLevel="None/Sign/EncryptAndSign" />
                                
                                    
                                          </security>
                                
                                    
                                       </binding>
                                
                                    
                                    </netTcpBinding>

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 applied. Valid values are shown below. The default value is Transport.

This attribute is of type SecurityMode.

mode Attribute

Value Description

None

Security is disabled.

Transport

Transport security is provided using TLS over TCP or SPNego. The service may need to be configured with SSL certificates. It is possible to control the protection level with this mode.

Message

Security is provided using SOAP message security. By default, the SOAP body is encrypted and signed. This mode offers a variety of features, such as whether the service credentials are available at the client out of band, the algorithm suite to use, and what level of protection to apply to the message body. Client authentication is performed once per session and the results of authentication are cached for the duration of the session.

TransportWithMessageCredential

Transport security is coupled with message security. Transport security is provided by TLS over TCP, or SPNego, and ensures integrity, confidentiality, and server authentication. SOAP message security provides client authentication. By default, client authentication is performed once per session and the results of authentication are cached for the duration of the session.

Child Elements

Element Description

<transport>of <netTcpBinding>

Defines the security settings for the transport. This element is of type TcpTransportSecurityElement.

<message> element of netTcpBinding

Defines the security settings for the message. This element is of type MessageSecurityOverTcpElement.

Parent Elements

Element Description

binding

The binding element of the <netNamedPipeBinding>.

See Also

Reference

NetTcpSecurity

Footer image

Send comments about this topic to Microsoft.
© Microsoft Corporation. All rights reserved.