SecurityBindingElement.CreateSecureConversationBindingElement Método

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v6.2.0

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.

Sobrecargas

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.
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. El token de contexto de seguridad emitido al final del protocolo de enlace de conversación seguro se usa para proteger los mensajes.
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. 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.

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement) As SecurityBindingElement

Parámetros

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement que contiene la especificación de cómo se protegen los mensajes de enlace de la conversación.

Devoluciones

SecurityBindingElement

Un objeto SecurityBindingElement.

Excepciones

ArgumentNullException

bootstrapSecurity es null.

Comentarios

El elemento de enlace se configura para utilizar los tokens de contexto de seguridad basados en sesión.

bootstrapSecurity se utiliza para indicar el enlace de seguridad y la directiva utilizada para solicitar un token de conversación seguro al servicio.

Si bootstrapSecurity es TransportSecurityBindingElement, el elemento de enlace devuelto por este método también es uno y IncludeTimestamp está establecido en true; y el objeto LocalClientSecuritySettings devuelto por LocalClientSettings tiene su propiedad DetectReplays establecida en false; y el objeto LocalServiceSecuritySettings devuelto por LocalServiceSettings tiene su propiedad DetectReplays establecida en false.

De lo contrario, se devuelve SymmetricSecurityBindingElement, con RequireSignatureConfirmation establecido en false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean) As SecurityBindingElement

Parámetros

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement que contiene la especificación de cómo se protegen los mensajes de enlace de la conversación.

requireCancellation

Boolean

true si se requiere la cancelación; de lo contrario, false. Establecer este parámetro en false habilita un token de contexto de seguridad que es útil en escenarios de granjas de servidores Web, porque en este modo el estado de sesión se codifica dentro del token de contexto de seguridad establecido en lugar de mantenerse en la memoria del servidor.

Devoluciones

SecurityBindingElement

Un objeto SecurityBindingElement.

Excepciones

ArgumentNullException

bootstrapSecurity es null.

Ejemplos

El siguiente código muestra cómo llamar a este método.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

// Use a secure session.
security = SecurityBindingElement.CreateSecureConversationBindingElement(security, true);

Comentarios

Si requireCancellation es false, se emiten tokens de contexto de seguridad basados en cookies; de lo contrario, se emiten tokens de contexto de seguridad basados en sesión.

bootstrapSecurity se utiliza para indicar el enlace de seguridad y la directiva utilizada para solicitar SecureConversationToken al servicio.

Si bootstrapSecurity es TransportSecurityBindingElement, el elemento de enlace devuelto por este método también es TransportSecurityBindingElement, y IncludeTimestamp está establecido en true; y el objeto LocalClientSecuritySettings devuelto por LocalClientSettings tiene su propiedad DetectReplays establecida en false; y el objeto LocalServiceSecuritySettings devuelto por LocalServiceSettings tiene su propiedad DetectReplays establecida en false.

De lo contrario, se devuelve SymmetricSecurityBindingElement, con RequireSignatureConfirmation establecido en false.

Nota:

Cuando se requiera suplantación en Windows XP, use una sesión segura sin un token de contexto de seguridad. Cuando se utilizan los tokens de contexto de seguridad con suplantación, se produce una excepción de la clase InvalidOperationException. Para más información, consulte Escenarios no admitidos. Para obtener más información sobre las sesiones seguras, consulte Sesiones seguras.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Source:

SecurityBindingElement.cs

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.

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation, System::ServiceModel::Security::ChannelProtectionRequirements ^ bootstrapProtectionRequirements);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation, System.ServiceModel.Security.ChannelProtectionRequirements bootstrapProtectionRequirements);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool * System.ServiceModel.Security.ChannelProtectionRequirements -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean, bootstrapProtectionRequirements As ChannelProtectionRequirements) As SecurityBindingElement

Parámetros

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement que contiene la especificación de cómo se protegen los mensajes de enlace de la conversación.

requireCancellation

Boolean

true si se requiere la cancelación; de lo contrario, false. Establecer este parámetro en false habilita un token de contexto de seguridad que es útil en escenarios de granjas de servidores Web, porque en este modo el estado de sesión se codifica dentro del token de contexto de seguridad establecido en lugar de mantenerse en la memoria del servidor.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Objeto ChannelProtectionRequirements que especifica los requisitos para la protección del canal.

Devoluciones

SecurityBindingElement

Un objeto SecurityBindingElement.

Excepciones

ArgumentNullException

bootstrapSecurity es null.

Comentarios

El parámetro bootstrapProtectionRequirements habilita la personalización de cómo se protegen los mensajes intercambiados como parte del protocolo de intercambio de conversación seguro.

bootstrapSecurity se utiliza para indicar el enlace de seguridad y la directiva utilizada para solicitar un token de conversación seguro al servicio.

Si bootstrapSecurity es TransportSecurityBindingElement, el elemento de enlace devuelto por este método también es TransportSecurityBindingElement, y IncludeTimestamp está establecido en true; y el objeto LocalClientSecuritySettings devuelto por LocalClientSettings tiene su propiedad DetectReplays establecida en false; y el objeto LocalServiceSecuritySettings devuelto por LocalServiceSettings tiene su propiedad DetectReplays establecida en false.

De lo contrario, se devuelve SymmetricSecurityBindingElement, con RequireSignatureConfirmation establecido en false.

Nota:

Cuando se requiera suplantación en Windows XP, use una sesión segura sin un token de contexto de seguridad. Cuando se utilizan los tokens de contexto de seguridad con suplantación, se produce una excepción de la clase InvalidOperationException. Para más información, consulte Escenarios no admitidos. Para obtener más información sobre las sesiones seguras, consulte Sesiones seguras.