SecurityBindingElement Clase

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblados:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v10.0.652802

Source:

SecurityBindingElement.cs

Una clase abstracta que, cuando se implementa, representa un elemento de enlace que admite la seguridad de mensajes SOAP de canal.

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

Object

BindingElement

SecurityBindingElement

Derivado

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Comentarios

Esta clase es la clase base para los elementos de enlace de seguridad de mensajes SOAP en WCF. Hay tres implementaciones de esta clase abstracta: SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementy TransportSecurityBindingElement. Estas implementaciones modelarán los enlaces definidos en la especificación de directiva de WS-Security.

Un enlace personalizado contiene una colección de elementos de enlace organizados en un orden específico: el elemento que representa la parte superior de la pila de enlace se agrega primero, se agrega el siguiente elemento en la pila de enlace en segundo lugar, etc.

Para agregar esta clase a un enlace, haga lo siguiente:

1. Crear un control BindingElementCollection.

2. Cree un elemento de enlace personalizado que esté encima de este elemento de enlace en la pila de enlaces, como opcional TransactionFlowBindingElement y ReliableSessionBindingElement.

3. Agregue estos elementos en el orden descrito anteriormente al BindingElementCollection mediante el InsertItem método .

4. Cree una instancia de un elemento de enlace de seguridad derivado de SecurityBindingElement, como AsymmetricSecurityBindingElement, SymmetricSecurityBindingElemento TransportSecurityBindingElement.

5. Agregue el elemento de enlace de seguridad derivado a la colección.

6. Agregue cualquier elemento de enlace personalizado adicional a la colección, como TcpTransportBindingElement.

Para obtener más información sobre el uso de , SecurityBindingElementvea SecurityBindingElement Authentication Modes y How to: Create a Custom Binding Using the SecurityBindingElement.

Nota:

Una vez creado un SecurityBindingElement objeto, debe tratar sus propiedades como inmutables. Llamar a set en algunas propiedades puede tener efectos imprevisibles: el enlace puede comportarse como si la propiedad conservase su valor anterior, con un error en tiempo de ejecución siendo la única indicación de un problema. Dos propiedades conocidas para comportarse de esta manera son KeyType y MessageSecurityVersion. Puede haber otras propiedades de las que también es cierto.

Propiedades

Nombre	Description
DefaultAlgorithmSuite	Obtiene o establece los algoritmos de cifrado de mensajes y de ajuste de claves.
EnableUnsecuredResponse	Obtiene o establece un valor que indica si WCF puede enviar y recibir respuestas no seguras a solicitudes protegidas.
EndpointSupportingTokenParameters	Obtiene el punto de conexión que admite parámetros de token.
IncludeTimestamp	Obtiene o establece un valor que indica si las marcas de tiempo se incluyen en cada mensaje.
KeyEntropyMode	Obtiene o establece el origen de la entropía que se usa para crear claves.
LocalClientSettings	Obtiene las propiedades de enlace específicas de la configuración de seguridad local usada por el cliente.
MessageSecurityVersion	Obtiene o establece la versión de seguridad del mensaje.
OperationSupportingTokenParameters	Obtiene la colección de operaciones que admiten parámetros de token.
OptionalEndpointSupportingTokenParameters	Obtiene los parámetros opcionales del token auxiliar para el punto de conexión de servicio.
OptionalOperationSupportingTokenParameters	Obtiene la colección de operaciones opcionales que admiten parámetros de token.
SecurityHeaderLayout	Obtiene o establece el orden de los elementos del encabezado de seguridad de este enlace.

Métodos

Nombre	Description
BuildChannelFactory<TChannel>(BindingContext)	Crea un generador de canales basado en la SecurityBindingElement configuración y el contexto de enlace pasado. El generador de canales creado es un generador de canales de seguridad de mensajes SOAP, que internamente tiene una referencia al generador de canales que corresponde al contexto de enlace (que incluye el generador de canales de transporte).
BuildChannelFactoryCore<TChannel>(BindingContext)	Cuando se implementa, crea un generador de canales de un tipo especificado.
CanBuildChannelFactory<TChannel>(BindingContext)	Determina si se puede crear un generador de canales del tipo especificado.
Clone()	Cuando se reemplaza en una clase derivada, devuelve una copia del objeto de elemento de enlace. (Heredado de BindingElement)
CreateCertificateOverTransportBindingElement()	Crea un elemento de enlace de seguridad que espera que los clientes realicen la autenticación basada en certificados mediante la seguridad de mensajes SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Crea un elemento de enlace de seguridad que espera que los clientes realicen la autenticación basada en certificados mediante la seguridad de mensajes SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Crea un elemento de enlace de seguridad configurado para requerir la autenticación de cliente basada en seguridad SOAP mediante un token emitido. Este elemento de enlace requiere el transporte para proporcionar autenticación de servidor y protección de mensajes (por ejemplo, HTTPS).
CreateMutualCertificateBindingElement()	Crea un elemento de enlace de seguridad asimétrico que está configurado para requerir la autenticación de cliente basada en certificados, así como la autenticación de servidor basada en certificados.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Crea un elemento de enlace de seguridad asimétrico que está configurado para requerir la autenticación de cliente basada en certificados, así como la autenticación de servidor basada en certificados.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Crea un elemento de enlace de seguridad asimétrico que está configurado para requerir la autenticación de cliente basada en certificados, así como la autenticación de servidor basada en certificados.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Crea un elemento de enlace de seguridad simétrico configurado para establecer una conversación segura entre el cliente y el servicio. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación segura se usa para proteger los mensajes. El elemento de enlace de seguridad bootstrap especifica cómo se protegen los mensajes de protocolo de enlace de conversación seguros.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Crea un elemento de enlace de seguridad simétrico configurado para establecer una conversación segura entre el cliente y el servicio. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación segura se usa para proteger los mensajes.
CreateSecureConversationBindingElement(SecurityBindingElement)	Crea un elemento de enlace de seguridad simétrico configurado para establecer una conversación segura entre el cliente y el servicio. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación segura se usa para proteger los mensajes. El elemento de enlace de seguridad bootstrap especifica cómo se protegen los mensajes de protocolo de enlace de conversación seguros.
CreateUserNameOverTransportBindingElement()	Crea un elemento de enlace de seguridad configurado para la autenticación de cliente en función de un nombre de usuario y una contraseña enviados como parte del mensaje SOAP. El elemento de enlace requiere el transporte para proporcionar autenticación del servidor y protección de mensajes (por ejemplo, HTTPS).
GetProperty<T>(BindingContext)	Obtiene un objeto especificado mediante el especificado BindingContext.
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Establece la clave de la propiedad de requisito de token cuyo valor es BindingContext que se usa para comunicarse con la entidad emisora si el requisito es para un token emitido.
SetKeyDerivation(Boolean)	Establece un valor que indica si se requieren claves derivadas.
ToString()	Devuelve una descripción de esta clase.

Consulte también

• Modos de autenticación de SecurityBindingElement
• Cómo: Crear un enlace personalizado mediante SecurityBindingElement