SecurityBindingElement Clase

Definición

Una clase abstracta que, cuando se implementa, representa un elemento de enlace que admite la seguridad de mensaje SOAP de canal.An abstract class that, when implemented, represents a binding element that supports channel SOAP message security.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement
public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement
type SecurityBindingElement = class
    inherit BindingElement
Public MustInherit Class SecurityBindingElement
Inherits BindingElement
Herencia
SecurityBindingElement
Derivado

Comentarios

Esta clase es la clase base para los elementos de enlace de seguridad de mensajes SOAP en WCF.This class is the base class for the SOAP message security binding elements in WCF. Hay tres implementaciones de esta clase abstracta: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementy TransportSecurityBindingElement.There are three implementations of this abstract class: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement, and TransportSecurityBindingElement. Estas implementaciones modelan los enlaces definidos en la especificación de la directiva WS-Security.These implementations model the bindings defined in the WS-Security Policy specification.

Un enlace personalizado contiene una colección de elementos de enlace organizada en un orden específico: primero se agrega el elemento que representa la parte superior de la pila de enlace, el elemento siguiente en la pila de enlace se agrega en segundo lugar, etc.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.

Para agregar esta clase a un enlace, haga lo siguiente:To add this class to a binding, do the following:

  1. Creará un control BindingElementCollection.Create a BindingElementCollection.

  2. Cree un elemento de enlace personalizado que sea anterior a este elemento de enlace en la pila de enlace, como el TransactionFlowBindingElement opcional y ReliableSessionBindingElement.Create a custom binding element that is above this binding element in the binding stack, such as the optional TransactionFlowBindingElement and ReliableSessionBindingElement.

  3. Agregue estos elementos en el orden descrito previamente a BindingElementCollection utilizando el método InsertItem.Add these elements in the order previously described to the BindingElementCollection using the InsertItem method.

  4. Cree una instancia de un elemento de enlace de seguridad derivado de SecurityBindingElement, como AsymmetricSecurityBindingElement, SymmetricSecurityBindingElemento TransportSecurityBindingElement.Create an instance of a security binding element derived from SecurityBindingElement, such as AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement, or TransportSecurityBindingElement.

  5. Agregue el elemento de enlace de seguridad derivado a la colección.Add the derived security binding element to the collection.

  6. Agregue cualquier elemento de enlace personalizado adicional a la colección, como la clase TcpTransportBindingElement.Add any additional custom binding elements to the collection, such as TcpTransportBindingElement.

Para obtener más información sobre el uso de SecurityBindingElement , vea modos de autenticación de SecurityBindingElement y Cómo: crear un enlace personalizado con SecurityBindingElement.For more information about using a SecurityBindingElement, see SecurityBindingElement Authentication Modes and How to: Create a Custom Binding Using the SecurityBindingElement.

Nota

Una vez creado un objeto SecurityBindingElement, debería tratar sus propiedades como inmutables.Once a SecurityBindingElement object is created, you should treat its properties as immutable. Llamar a set algunas propiedades puede tener efectos imprevisibles: el enlace puede comportarse como si la propiedad hubiese retenido su valor anterior, con un error en tiempo de ejecución como única indicación de un problema.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. Dos propiedades conocidas por comportarse de esta manera son KeyType y MessageSecurityVersion.Two properties known to behave this way are KeyType and MessageSecurityVersion. Puede haber otras propiedades para las que esto también sea verdad.There may be other properties of which this is also true.

Propiedades

AllowInsecureTransport

Obtiene o establece un valor que indica si los mensajes seguros en modo mixto se pueden enviar a través de un transporte no seguro como HTTP.Gets or sets a value that indicates whether mixed-mode secured messages can be sent over an unsecured transport such as HTTP.

DefaultAlgorithmSuite

Obtiene o establece el cifrado de mensajes y los algoritmos de encapsulado de claves.Gets or sets the message encryption and key-wrap algorithms.

EnableUnsecuredResponse

Obtiene o establece un valor que indica si WCF puede enviar y recibir respuestas no seguras a solicitudes seguras.Gets or sets a value that indicates whether WCF can send and receive unsecured responses to secured requests.

EndpointSupportingTokenParameters

Obtiene el extremo que admite los parámetros de token.Gets the endpoint that supports token parameters.

IncludeTimestamp

Obtiene o establece un valor que indica si las marcas de tiempo están incluidas en cada mensaje.Gets or sets a value that indicates whether time stamps are included in each message.

KeyEntropyMode

Obtiene o establece el origen de entropía usado para crear claves.Gets or sets the source of entropy used to create keys.

LocalClientSettings

Obtiene las propiedades de enlace específicas de la configuración de seguridad local utilizada por el cliente.Gets the binding properties specific to local security settings used by the client.

LocalServiceSettings

Obtiene las propiedades de enlace específicas de la configuración de seguridad local utilizada por el servicio.Gets the binding properties specific to local security settings used by the service.

MessageSecurityVersion

Obtiene o establece la versión de seguridad de mensaje.Gets or sets the message security version.

OperationSupportingTokenParameters

Obtiene la colección de parámetros de tokens auxiliares de operación.Gets the collection of operation supporting token parameters.

OptionalEndpointSupportingTokenParameters

Obtiene los parámetros de tokens auxiliares opcionales para el punto de conexión de servicio.Gets the optional supporting token parameters for the service endpoint.

OptionalOperationSupportingTokenParameters

Obtiene la colección de parámetros de tokens auxiliares de operación opcionales.Gets the collection of optional operation supporting token parameters.

ProtectTokens

Obtiene o establece si el elemento de enlace de seguridad protege los tokens.Gets or sets whether the security binding element protects tokens.

SecurityHeaderLayout

Obtiene o establece el orden de los elementos en el encabezado de seguridad para este enlace.Gets or sets the ordering of the elements in the security header for this binding.

Métodos

BuildChannelFactory<TChannel>(BindingContext)

Crea un generador de canales basándose en la configuración de la clase SecurityBindingElement y en el contexto del enlace que se pasa.Creates a channel factory based on the SecurityBindingElement settings and the binding context passed in. El generador de canales creado es un generador de canales de seguridad de mensaje SOAP, que internamente tiene una referencia al generador de canales que corresponde al contexto de enlace (que incluye el generador de canales de transporte).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).

BuildChannelFactoryCore<TChannel>(BindingContext)

Cuando se implementa, crea un generador de canales de un tipo especificado.When implemented, creates a channel factory of a specified type.

BuildChannelListener<TChannel>(BindingContext)

Crea una escucha del canal basada en los valores SecurityBindingElement y el contexto de enlace pasado.Creates a channel listener based on the SecurityBindingElement settings and the binding context passed in.

BuildChannelListener<TChannel>(BindingContext)

Inicializa una escucha de canales para aceptar canales de un tipo especificado a partir del contexto de enlace.Initializes a channel listener to accept channels of a specified type from the binding context.

(Heredado de BindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)

Cuando se implementa, crea una escucha de canales de un tipo especificado.When implemented, creates a channel listener of a specified type.

CanBuildChannelFactory<TChannel>(BindingContext)

Determina si se puede crear un generador de canales del tipo especificado.Determines whether a channel factory of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext)

Determina si se puede crear una escucha de canales del tipo especificado.Determines whether a channel listener of the specified type can be built.

CanBuildChannelListener<TChannel>(BindingContext)

Devuelve un valor que indica si el elemento de enlace puede compilar una escucha para un tipo específico de canal.Returns a value that indicates whether the binding element can build a listener for a specific type of channel.

(Heredado de BindingElement)
Clone()

Devuelve una copia del objeto de elemento de enlace cuando se invalida en una clase derivada.When overridden in a derived class, returns a copy of the binding element object.

(Heredado de BindingElement)
CreateAnonymousForCertificateBindingElement()

Crea un elemento de enlace de seguridad simétrico que se configura para la autenticación anónima de cliente y la autenticación de servidor basada en certificado.Creates a symmetric security binding element that is configured for anonymous client authentication and certificate-based server authentication.

CreateCertificateOverTransportBindingElement()

Crea un elemento de enlace de seguridad que espera que los clientes realicen la autenticación basada en certificados mediante la seguridad del mensaje SOAP.Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

CreateCertificateOverTransportBindingElement(MessageSecurityVersion)

Crea un elemento de enlace de seguridad que espera que los clientes realicen la autenticación basada en certificados mediante la seguridad del mensaje SOAP.Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security.

CreateCertificateSignatureBindingElement()

Crea un elemento de enlace utilizando un certificado para firmar los mensajes.Creates a binding element using a certificate to sign messages. Este elemento de enlace se puede utilizar sólo para los intercambios de mensajes unidireccionales y es capaz de firmar sólo el mensaje.This binding element can be used only for one-way message exchanges and is capable only of signing the message.

CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

Crea un elemento de enlace de seguridad simétrico que se configura para requerir autenticación del cliente mediante un token emitido basado en clave simétrica.Creates a symmetric security binding element that is configured to require client authentication using a symmetric-key based issued token.

CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

Crea un elemento de enlace de seguridad simétrico que se configura para requerir la autenticación de cliente basada en un token emitido y la autenticación de servidor basada en el certificado de servidor.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.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

Crea un elemento de enlace de seguridad simétrico que se configura para requerir la autenticación de cliente basada en un token emitido y la autenticación de servidor basada en el certificado de servidor.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.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

Crea un elemento de enlace de seguridad simétrico que se configura para requerir la autenticación de cliente basada en un token emitido y la autenticación de servidor basada en el certificado de servidor.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.

CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)

Crea un elemento de enlace de seguridad configurado para requerir seguridad de SOAP basada en autenticación del cliente mediante un token emitido.Creates a security binding element configured to require SOAP security based client authentication using an issued token. Este elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateKerberosBindingElement()

Crea un elemento de enlace de seguridad simétrico que se configura para requerir la autenticación del cliente basada en el token Kerberos del cliente.Creates a symmetric security binding element that is configured to require client authentication based on the client's Kerberos token.

CreateKerberosOverTransportBindingElement()

Crea un elemento de enlace de seguridad que se configura para requerir la autenticación de cliente basada en seguridad de SOAP mediante el token Kerberos del cliente.Creates a security binding element that is configured to require SOAP-security based client authentication using the client's Kerberos token. Este elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateMutualCertificateBindingElement()

Crea un elemento de enlace de seguridad asimétrico que se configura para requerir la autenticación de cliente basada en certificado así como la autenticación de servidor basada en certificado.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Crea un elemento de enlace de seguridad asimétrico que se configura para requerir la autenticación de cliente basada en certificado así como la autenticación de servidor basada en certificado.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Crea un elemento de enlace de seguridad asimétrico que se configura para requerir la autenticación de cliente basada en certificado así como la autenticación de servidor basada en certificado.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.

CreateMutualCertificateDuplexBindingElement()

Crea un elemento de enlace de seguridad asimétrico que se configura para requerir la autenticación de cliente basada en certificado así como la autenticación de servidor basada en certificado.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. Este modo de autenticación se puede utilizar para proteger los modelos de intercambio de mensajes dúplex y exige que el servicio esté configurado con el certificado de cliente fuera de la banda.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.

CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

Crea un elemento de enlace de seguridad asimétrico que se configura para requerir la autenticación de cliente basada en certificado así como la autenticación de servidor basada en certificado.Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. Este modo de autenticación se puede utilizar para proteger los modelos de intercambio de mensajes dúplex y exige que el servicio esté configurado con el certificado de cliente fuera de la banda.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.

CreateSecureConversationBindingElement(SecurityBindingElement)

Crea un elemento de enlace de seguridad simétrico que se configura para establecer una conversación segura entre el cliente y el servicio.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación seguro se usa para proteger los mensajes.The security context token issued at the end of the secure conversation handshake is used to secure the messages. El elemento de enlace de seguridad de arranque especifica cómo se protegen los mensajes de protocolo de intercambio de conversación seguros.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Crea un elemento de enlace de seguridad simétrico que se configura para establecer una conversación segura entre el cliente y el servicio.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación seguro se usa para proteger los mensajes.The security context token issued at the end of the secure conversation handshake is used to secure the messages.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Crea un elemento de enlace de seguridad simétrico que se configura para establecer una conversación segura entre el cliente y el servicio.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación seguro se usa para proteger los mensajes.The security context token issued at the end of the secure conversation handshake is used to secure the messages. El elemento de enlace de seguridad de arranque especifica cómo se protegen los mensajes de protocolo de intercambio de conversación seguros.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

CreateSslNegotiationBindingElement(Boolean)

Crea un elemento de enlace de seguridad simétrico que está configurado para realizar negociación SSL en el nivel SOAP entre el cliente y el servidor, teniendo en cuenta si se requiere un certificado de cliente.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.

CreateSslNegotiationBindingElement(Boolean, Boolean)

Crea un elemento de enlace de seguridad simétrico que realiza negociación SSL SOAP, teniendo en cuenta si se requiere un certificado de cliente y la cancelación.Creates a symmetric security binding element that does SOAP SSL negotiation, noting whether a client certificate and cancellation is required.

CreateSspiNegotiationBindingElement()

Crea un elemento de enlace de seguridad simétrico que realiza negociación SSPI SOAP basada en Negociar paquete de autenticación.Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

CreateSspiNegotiationBindingElement(Boolean)

Crea un elemento de enlace de seguridad simétrico que realiza negociación SSPI SOAP basada en Negociar paquete de autenticación.Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.

CreateSspiNegotiationOverTransportBindingElement()

Crea un elemento de enlace de seguridad que se configura para la autenticación del cliente basada en la negociación SSPI SOAP utilizando Negociar paquete de autenticación.Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. El elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateSspiNegotiationOverTransportBindingElement(Boolean)

Crea un elemento de enlace de seguridad que se configura para la autenticación del cliente basada en la negociación SSPI SOAP utilizando Negociar paquete de autenticación.Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. El elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

CreateUserNameForCertificateBindingElement()

Crea un elemento de enlace de seguridad simétrico que se configura para requerir autenticación de cliente basada en nombre de usuario y contraseña y autenticación de servidor basada en certificado.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. El elemento de enlace creado exige configurar el cliente con un certificado de servicio que sea fuera de banda antes de abrir un canal de comunicación con un servicio.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.

CreateUserNameForSslBindingElement()

Crea un elemento de enlace de seguridad simétrico que se configura para requerir autenticación de cliente basada en nombre de usuario y contraseña y autenticación de servidor basada en certificado.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. El cliente autentica el servidor mediante el protocolo SSL de nivel de SOAP.The client authenticates the server using the SOAP-level SSL protocol.

CreateUserNameForSslBindingElement(Boolean)

Crea un elemento de enlace de seguridad simétrico que se configura para requerir autenticación de cliente basada en nombre de usuario y contraseña y autenticación de servidor basada en certificado.Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. El cliente autentica el servidor mediante el protocolo SSL de nivel de SOAP.The client authenticates the server using the SOAP-level SSL protocol.

CreateUserNameOverTransportBindingElement()

Crea un elemento de enlace de seguridad que se configura para la autenticación del cliente basada en un nombre de usuario y contraseña que se envían como parte del mensaje SOAP.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. El elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetProperty<T>(BindingContext)

Obtiene un objeto especificado utilizando el BindingContext especificado.Gets a specified object using the specified BindingContext.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)

Establece la clave de la propiedad de requisito de token cuyo valor es el BindingContext que se usa para comunicar con la parte emisora cuando el requisito es para un token emitido.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.

SetKeyDerivation(Boolean)

Establece un valor que indica si se requieren claves derivadas.Sets a value that indicates whether derived keys are required.

ToString()

Devuelve una descripción de esta clase.Returns a description of this class.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también