Export (0) Print
Expand All

SecurityBindingElement.CreateMutualCertificateBindingElement Method (MessageSecurityVersion)

Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public static SecurityBindingElement CreateMutualCertificateBindingElement(
	MessageSecurityVersion version
)

Parameters

version
Type: System.ServiceModel.MessageSecurityVersion

The message security version.

ExceptionCondition
ArgumentNullException

version is null.

If the version is WSSecurity10, then the binding element is configured so that the client request is signed by its certificate and encrypted with the server certificate.

If the version is WSSecurity11, then the binding element is configured so that a new random symmetric key (encrypted for the server) is generated for every request by the client and is used to protect the request as well as the response from the server. The client's certificate is used as an endorsing supporting token on the request.

NoteNote

Once a SecurityBindingElement object is created by calling this method, the MessageSecurityVersion property is immutable. Calling set on it does not change it.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft