Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SecurityBindingElement Class

 

An abstract class that, when implemented, represents a binding element that supports channel SOAP message security.

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


public abstract class SecurityBindingElement : BindingElement

NameDescription
System_CAPS_pubpropertyAllowInsecureTransport

Gets or sets a value that indicates whether mixed-mode secured messages can be sent over an unsecured transport such as HTTP.

System_CAPS_pubpropertyDefaultAlgorithmSuite

Gets or sets the message encryption and key-wrap algorithms.

System_CAPS_pubpropertyEnableUnsecuredResponse

Gets or sets a value that indicates whether WCF can send and receive unsecured responses to secured requests.

System_CAPS_pubpropertyEndpointSupportingTokenParameters

Gets the endpoint that supports token parameters.

System_CAPS_pubpropertyIncludeTimestamp

Gets or sets a value that indicates whether time stamps are included in each message.

System_CAPS_pubpropertyKeyEntropyMode

Gets or sets the source of entropy used to create keys.

System_CAPS_pubpropertyLocalClientSettings

Gets the binding properties specific to local security settings used by the client.

System_CAPS_pubpropertyLocalServiceSettings

Gets the binding properties specific to local security settings used by the service.

System_CAPS_pubpropertyMessageSecurityVersion

Gets or sets the message security version.

System_CAPS_pubpropertyOperationSupportingTokenParameters

Gets the collection of operation supporting token parameters.

System_CAPS_pubpropertyOptionalEndpointSupportingTokenParameters

Gets the optional supporting token parameters for the service endpoint.

System_CAPS_pubpropertyOptionalOperationSupportingTokenParameters

Gets the collection of optional operation supporting token parameters.

System_CAPS_pubpropertyProtectTokens

Gets or sets whether the security binding element protects tokens.

System_CAPS_pubpropertySecurityHeaderLayout

Gets or sets the ordering of the elements in the security header for this binding.

NameDescription
System_CAPS_pubmethodBuildChannelFactory<TChannel>(BindingContext)

Creates a channel factory based on the SecurityBindingElement settings and the binding context passed in. The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory).(Overrides BindingElement.BuildChannelFactory<TChannel>(BindingContext).)

System_CAPS_protmethodBuildChannelFactoryCore<TChannel>(BindingContext)

When implemented, creates a channel factory of a specified type.

System_CAPS_pubmethodBuildChannelListener<TChannel>(BindingContext)

Creates a channel listener based on the SecurityBindingElement settings and the binding context passed in. (Overrides BindingElement.BuildChannelListener<TChannel>(BindingContext).)

System_CAPS_protmethodBuildChannelListenerCore<TChannel>(BindingContext)

When implemented, creates a channel listener of a specified type.

System_CAPS_pubmethodCanBuildChannelFactory<TChannel>(BindingContext)

Determines whether a channel factory of the specified type can be built. (Overrides BindingElement.CanBuildChannelFactory<TChannel>(BindingContext).)

System_CAPS_pubmethodCanBuildChannelListener<TChannel>(BindingContext)

Determines whether a channel listener of the specified type can be built.(Overrides BindingElement.CanBuildChannelListener<TChannel>(BindingContext).)

System_CAPS_pubmethodClone()

When overridden in a derived class, returns a copy of the binding element object.(Inherited from BindingElement.)

System_CAPS_pubmethodSystem_CAPS_staticCreateAnonymousForCertificateBindingElement()

Creates a symmetric security binding element that is configured for anonymous client authentication and certificate-based server authentication.

System_CAPS_pubmethodSystem_CAPS_staticCreateCertificateOverTransportBindingElement()

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

System_CAPS_pubmethodSystem_CAPS_staticCreateCertificateOverTransportBindingElement(MessageSecurityVersion)

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

System_CAPS_pubmethodSystem_CAPS_staticCreateCertificateSignatureBindingElement()

Creates a binding element using a certificate to sign messages. This binding element can be used only for one-way message exchanges and is capable only of signing the message.

System_CAPS_pubmethodSystem_CAPS_staticCreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

Creates a symmetric security binding element that is configured to require client authentication using a symmetric-key based issued token.

System_CAPS_pubmethodSystem_CAPS_staticCreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

System_CAPS_pubmethodSystem_CAPS_staticCreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

System_CAPS_pubmethodSystem_CAPS_staticCreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.

System_CAPS_pubmethodSystem_CAPS_staticCreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)

Creates a security binding element configured to require SOAP security based client authentication using an issued token. This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

System_CAPS_pubmethodSystem_CAPS_staticCreateKerberosBindingElement()

Creates a symmetric security binding element that is configured to require client authentication based on the client's Kerberos token.

System_CAPS_pubmethodSystem_CAPS_staticCreateKerberosOverTransportBindingElement()

Creates a security binding element that is configured to require SOAP-security based client authentication using the client's Kerberos token. This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

System_CAPS_pubmethodSystem_CAPS_staticCreateMutualCertificateBindingElement()

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

System_CAPS_pubmethodSystem_CAPS_staticCreateMutualCertificateBindingElement(MessageSecurityVersion)

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

System_CAPS_pubmethodSystem_CAPS_staticCreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

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

System_CAPS_pubmethodSystem_CAPS_staticCreateMutualCertificateDuplexBindingElement()

Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. This authentication mode can be used to secure duplex message-exchange patterns and requires the service to be configured with the client certificate out of band.

System_CAPS_pubmethodSystem_CAPS_staticCreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. This authentication mode can be used to secure duplex message exchange patterns and requires the service to be configured with the client certificate out of band.

System_CAPS_pubmethodSystem_CAPS_staticCreateSecureConversationBindingElement(SecurityBindingElement)

Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. The security context token issued at the end of the secure conversation handshake is used to secure the messages. The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

System_CAPS_pubmethodSystem_CAPS_staticCreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. The security context token issued at the end of the secure conversation handshake is used to secure the messages.

System_CAPS_pubmethodSystem_CAPS_staticCreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. The security context token issued at the end of the secure conversation handshake is used to secure the messages. The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

System_CAPS_pubmethodSystem_CAPS_staticCreateSslNegotiationBindingElement(Boolean)

Creates a symmetric security binding element that is configured to do SOAP-level SSL negotiation between the client and server, noting whether a client certificate is required.

System_CAPS_pubmethodSystem_CAPS_staticCreateSslNegotiationBindingElement(Boolean, Boolean)

Creates a symmetric security binding element that does SOAP SSL negotiation, noting whether a client certificate and cancellation is required.

System_CAPS_pubmethodSystem_CAPS_staticCreateSspiNegotiationBindingElement()

Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

System_CAPS_pubmethodSystem_CAPS_staticCreateSspiNegotiationBindingElement(Boolean)

Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

System_CAPS_pubmethodSystem_CAPS_staticCreateSspiNegotiationOverTransportBindingElement()

Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

System_CAPS_pubmethodSystem_CAPS_staticCreateSspiNegotiationOverTransportBindingElement(Boolean)

Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

System_CAPS_pubmethodSystem_CAPS_staticCreateUserNameForCertificateBindingElement()

Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. The created binding element requires the client to be configured with a service certificate that is out-of-band before opening a communication channel with a service.

System_CAPS_pubmethodSystem_CAPS_staticCreateUserNameForSslBindingElement()

Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. The client authenticates the server using the SOAP-level SSL protocol.

System_CAPS_pubmethodSystem_CAPS_staticCreateUserNameForSslBindingElement(Boolean)

Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. The client authenticates the server using the SOAP-level SSL protocol.

System_CAPS_pubmethodSystem_CAPS_staticCreateUserNameOverTransportBindingElement()

Creates a security binding element that is configured for client authentication based on a user name and password sent as part of the SOAP message. The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetProperty<T>(BindingContext)

Gets a specified object using the specified BindingContext.(Overrides BindingElement.GetProperty<T>(BindingContext).)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodSystem_CAPS_staticSetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)

This API supports the product infrastructure and is not intended to be used directly from your code. Sets the key for the token requirement property whose value is the BindingContext used to talk to the issuing party if the requirement is for an issued token.

System_CAPS_pubmethodSetKeyDerivation(Boolean)

Sets a value that indicates whether derived keys are required.

System_CAPS_pubmethodToString()

Returns a description of this class.(Overrides Object.ToString().)

This class is the base class for the SOAP message security binding elements in WCF. There are three implementations of this abstract class: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement, and TransportSecurityBindingElement. These implementations model the bindings defined in the WS-Security Policy specification.

A custom binding contains a collection of binding elements arranged in a specific order: the element that represents the top of the binding stack is added first, the next element down in the binding stack is added second, and so on.

To add this class to a binding, do the following:

  1. Create a BindingElementCollection.

  2. Create a custom binding element that is above this binding element in the binding stack, such as the optional TransactionFlowBindingElement and ReliableSessionBindingElement.

  3. Add these elements in the order previously described to the BindingElementCollection using the InsertItem method.

  4. Create an instance of a security binding element derived from SecurityBindingElement, such as AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement, or TransportSecurityBindingElement.

  5. Add the derived security binding element to the collection.

  6. Add any additional custom binding elements to the collection, such as TcpTransportBindingElement.

For more information about using a SecurityBindingElement, see SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement.

System_CAPS_noteNote

Once a SecurityBindingElement object is created, you should treat its properties as immutable. Calling set on some properties may have unpredictable effects: the binding may behave as if the property retained its old value, with a runtime failure being the only indication of an issue. Two properties known to behave this way are KeyType and MessageSecurityVersion. There may be other properties of which this is also true.

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 3.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft