SecurityBindingElement Clase

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v8.0.0

Source:

SecurityBindingElement.cs

Una clase abstracta que, cuando se implementa, representa un elemento de enlace que admite la seguridad de mensaje 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 modelan los enlaces definidos en la especificación de la directiva WS-Security.

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.

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

1. Creará un control 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.

3. Agregue estos elementos en el orden descrito previamente a BindingElementCollection utilizando el método InsertItem.

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 la clase 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 objeto SecurityBindingElement, debería tratar sus propiedades como inmutables. 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. Dos propiedades conocidas por comportarse de esta manera son KeyType y MessageSecurityVersion. Puede haber otras propiedades para las que esto también sea verdad.

Propiedades

DefaultAlgorithmSuite	Obtiene o establece el cifrado de mensajes y los algoritmos de encapsulado de claves.
EnableUnsecuredResponse	Obtiene o establece un valor que indica si WCF puede enviar y recibir respuestas no seguras a solicitudes seguras.
EndpointSupportingTokenParameters	Obtiene el extremo que admite los parámetros de token.
IncludeTimestamp	Obtiene o establece un valor que indica si las marcas de tiempo están incluidas en cada mensaje.
KeyEntropyMode	Obtiene o establece el origen de entropía usado para crear claves.
LocalClientSettings	Obtiene las propiedades de enlace específicas de la configuración de seguridad local utilizada por el cliente.
MessageSecurityVersion	Obtiene o establece la versión de seguridad de mensaje.
SecurityHeaderLayout	Obtiene o establece el orden de los elementos en el encabezado de seguridad para este enlace.

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. 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).
BuildChannelFactoryCore<TChannel>(BindingContext)	Cuando se implementa, crea un generador de canales de un tipo especificado.
BuildChannelListener<TChannel>(BindingContext)	Inicializa una escucha de canales para aceptar canales de un tipo especificado a partir del contexto de enlace. (Heredado de BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Determina si se puede crear un generador de canales del tipo especificado.
CanBuildChannelListener<TChannel>(BindingContext)	Devuelve un valor que indica si el elemento de enlace puede compilar una escucha para un tipo específico de canal. (Heredado de BindingElement)
Clone()	Devuelve una copia del objeto de elemento de enlace cuando se invalida en una clase derivada. (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 del mensaje 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 del mensaje SOAP.
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. Este elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).
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. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación seguro se usa para proteger los mensajes. El elemento de enlace de seguridad de arranque especifica cómo se protegen los mensajes de protocolo de intercambio de conversación seguros.
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. El elemento de enlace exige al transporte que proporcione autenticación de servidor y protección de mensaje (por ejemplo, HTTPS).
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetProperty<T>(BindingContext)	Obtiene un objeto especificado utilizando el BindingContext especificado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
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