Cómo: Crear un enlace personalizado mediante SecurityBindingElement

Windows Communication Foundation (WCF) incluye varios enlaces proporcionados por el sistema que se pueden configurar pero que no proporcionan completa flexibilidad cuando se configuran todas las opciones de seguridad que WCF admite. Este tema muestra cómo crear un enlace personalizado directamente a partir de elementos de enlace individuales y resalta algunos de los ajustes de seguridad que pueden especificarse al crear este tipo de enlaces. Para obtener más información acerca de creación de enlaces personalizados, vea Extensión de enlaces.

Creación de un enlace personalizado

En WCF todos los enlaces se componen de elementos de enlace. Cada elemento de enlace deriva de la clase BindingElement. En el caso de los enlaces estándar proporcionados por el sistema, los elementos de enlace se crean y se configuran automáticamente, pero se pueden personalizar algunos de los valores de las propiedades.

Por el contrario, para crear un enlace personalizado, se crean y configuran los elementos de enlace y se crea un objeto CustomBinding a partir de los elementos de enlace.

Para ello, se agregan los elementos de enlace individuales a una colección representada por una instancia de la clase BindingElementCollection y, a continuación, se establece la propiedad Elements de CustomBinding en ese objeto. Debe agregar los elementos de enlace en el orden siguiente: flujo de transacciones, sesión confiable, seguridad, dúplex compuesto, unidireccional, seguridad de secuencia, codificación de mensajes y transporte. Tenga en cuenta que no todos los elementos de enlace enumerados se necesitan en cada enlace.

SecurityBindingElement

Tres elementos de enlace guardan relación con la seguridad, y todos se derivan de la clase SecurityBindingElement. Los tres elementos son TransportSecurityBindingElement, SymmetricSecurityBindingElement y AsymmetricSecurityBindingElement. TransportSecurityBindingElement se utiliza para proporcionar seguridad de modo mixto. Se utilizan los otros dos elementos cuando la capa del mensaje proporciona seguridad.

Se utilizan clases adicionales cuando se proporciona seguridad de nivel de transporte:

• HttpsTransportBindingElement
• SslStreamSecurityBindingElement
• WindowsStreamSecurityBindingElement

Elementos de enlace necesarios

Hay un gran número de posibles elementos de enlace que se pueden combinar en un enlace. No todas estas combinaciones son válidas. En esta sección se describen los elementos necesarios que se deben encontrar en un enlace de seguridad.

La validez de los enlaces de seguridad depende de muchos factores, como los siguientes:

• Modo de seguridad.
• Protocolo de transporte.
• El modelo de intercambio de mensajes (MEP) especificado en el contrato.

En la tabla siguiente se muestran las configuraciones de pila de los elementos de enlace válidos para cada combinación de los factores mencionados. Tenga en cuenta que éstos son los requisitos mínimos. Puede agregar otros elementos de enlace al enlace, como elementos de enlace de codificación de mensajes y elementos de enlace de transacción.

Modo de seguridad	Transporte	Modelo de intercambio de mensajes de contrato
		Datagrama	Respuesta a solicitud	Dúplex
Transporte	Https
		OneWayBindingElement
		HttpsTransportBindingElement	HttpsTransportBindingElement
	TCP
		OneWayBindingElement
		SSL o StreamSecurityBindingElement de Windows	SSL o StreamSecurityBindingElement de Windows	SSL o StreamSecurityBindingElement de Windows
		TcpTransportBindingElement	TcpTransportBindingElement	TcpTransportBindingElement
Mensaje	Http	SymmetricSecurityBindingElement	SymmetricSecurityBindingElement	SymmetricSecurityBindingElement (modo de autenticación = SecureConversation)
				CompositeDuplexBindingElement
		OneWayBindingElement		OneWayBindingElement
		HttpTransportBindingElement	HttpTransportBindingElement	HttpTransportBindingElement
	Tcp	SecurityBindingElement	SecurityBindingElement	SymmetricSecurityBindingElement (modo de autenticación = SecureConversation)
		TcpTransportBindingElement	TcpTransportBindingElement	TcpTransportBindingElement
Mixto (transporte con credenciales de mensaje)	Https	TransportSecurityBindingElement	TransportSecurityBindingElement
		OneWayBindingElement
		HttpsTransportBindingElement	HttpsTransportBindingElement
	TCP	TransportSecurityBindingElement	SymmetricSecurityBindingElement (modo de autenticación = SecureConversation)	SymmetricSecurityBindingElement (modo de autenticación = SecureConversation)
		OneWayBindingElement
		SSL o StreamSecurityBindingElement de Windows	SSL o StreamSecurityBindingElement de Windows	SSL o StreamSecurityBindingElement de Windows
		TcpTransportBindingElement	TcpTransportBindingElement	TcpTransportBindingElement

Observe que hay muchos valores de configuración que se pueden definir en SecurityBindingElements. Para obtener más información, consulte Modos de autenticación de SecurityBindingElement.

Para obtener más información, consulte Conversaciones y sesiones seguras.

Procedimientos

Para crear un enlace personalizado que utilice un SymmetricSecurityBindingElement

1. Cree una instancia de la clase BindingElementCollection con el nombre outputBec.

2. Llame al método estático M:System.ServiceModel.Channels.SecurityBindingElement.CreateSspiNegotiationBindingElement(true), que devuelve una instancia de la clase SymmetricSecurityBindingElement.

3. Agregue el SymmetricSecurityBindingElement a la colección (outputBec) llamando a Add del método de la Collection de la clase BindingElement.

4. Cree una instancia de la clase TextMessageEncodingBindingElement y agréguela a la colección (outputBec). Esto especifica la codificación utilizada por el enlace.

5. Cree un HttpTransportBindingElement y agréguelo a la colección (outputBec). Esto especifica que el enlace utiliza el transporte HTTP.

6. Cree un nuevo enlace personalizado creando una instancia de la clase CustomBinding y pasando la colección outputBec al constructor.

7. El enlace personalizado resultante comparte muchas de las mismas características que el WSHttpBinding estándar. Especifica seguridad del nivel de mensaje y credenciales de Windows pero deshabilita las sesiones seguras, requiere que la credencial del servicio se especifique fuera de banda, y no cifra las firmas. Lo último sólo puede controlarse estableciendo la propiedad MessageProtectionOrder como se muestra en el paso 4. Los otros dos se pueden controlar utilizando los valores en el enlace estándar.

Ejemplo

Descripción

El ejemplo siguiente proporciona una función completa para crear un enlace personalizado que utilice SymmetricSecurityBindingElement.

Código

Consulte también

Referencia

SecurityBindingElement
TransportSecurityBindingElement
SymmetricSecurityBindingElement
CustomBinding

Conceptos

Enlaces proporcionados por el sistema

Otros recursos

Extensión de enlaces