SecurityBindingElement.CreateCertificateOverTransportBindingElement Method

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v6.2.0

Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security. This binding element expects the transport to provide server authentication as well as message protection (for example, HTTPS).

Overloads

CreateCertificateOverTransportBindingElement()	Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

Remarks

The client must be configured with a certificate it uses for authentication.

Note

Once a SecurityBindingElement object is created by calling this method, the MessageSecurityVersion property should be treated as immutable. Inconsistent binding behavior may occur if this value is modified.

CreateCertificateOverTransportBindingElement()

Source:

SecurityBindingElement.cs

Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

public:
 static System::ServiceModel::Channels::TransportSecurityBindingElement ^ CreateCertificateOverTransportBindingElement();

public static System.ServiceModel.Channels.TransportSecurityBindingElement CreateCertificateOverTransportBindingElement ();

static member CreateCertificateOverTransportBindingElement : unit -> System.ServiceModel.Channels.TransportSecurityBindingElement

Public Shared Function CreateCertificateOverTransportBindingElement () As TransportSecurityBindingElement

Returns

TransportSecurityBindingElement

A TransportSecurityBindingElement object.

Remarks

This binding element expects the transport to provide server authentication as well as message protection (for example, HTTPS).

The binding element is configured to use the Default property of the MessageSecurityVersion class.

The created binding has IncludeTimestamp set to true.

The LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false.

The LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

CreateCertificateOverTransportBindingElement(MessageSecurityVersion)

Source:

SecurityBindingElement.cs

Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

public:
 static System::ServiceModel::Channels::TransportSecurityBindingElement ^ CreateCertificateOverTransportBindingElement(System::ServiceModel::MessageSecurityVersion ^ version);

public static System.ServiceModel.Channels.TransportSecurityBindingElement CreateCertificateOverTransportBindingElement (System.ServiceModel.MessageSecurityVersion version);

static member CreateCertificateOverTransportBindingElement : System.ServiceModel.MessageSecurityVersion -> System.ServiceModel.Channels.TransportSecurityBindingElement

Public Shared Function CreateCertificateOverTransportBindingElement (version As MessageSecurityVersion) As TransportSecurityBindingElement

Parameters

version

MessageSecurityVersion

The MessageSecurityVersion for the binding.

Returns

TransportSecurityBindingElement

A TransportSecurityBindingElement object.

Exceptions

ArgumentNullException

version is null.

Remarks

This binding element expects the transport to provide server authentication as well as message protection (for example, HTTPS). The binding element is configured with the specified MessageSecurityVersion.

The created binding has IncludeTimestamp set to true.

The LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false.

The LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.