SecurityBindingElement.CreateSecureConversationBindingElement Método

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v6.2.0

Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.

Sobrecargas

CreateSecureConversationBindingElement(SecurityBindingElement)	Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.

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

Um SecurityBindingElement que contém uma especificação sobre como as mensagens de handshake de conversa segura são protegidas.

Retornos

SecurityBindingElement

Um objeto SecurityBindingElement.

Exceções

ArgumentNullException

bootstrapSecurity é null.

Comentários

O elemento de associação é configurado para usar tokens de contexto de segurança baseados em sessão.

O bootstrapSecurity é usado para indicar a associação de segurança e a política usadas para solicitar um token de conversa segura do serviço.

Se bootstrapSecurity for um TransportSecurityBindingElement, o elemento de associação retornado por esse método também será um e IncludeTimestamp será definido como true; e o LocalClientSecuritySettings objeto retornado de LocalClientSettings tem sua DetectReplays propriedade definida como false; e o LocalServiceSecuritySettings objeto retornado de LocalServiceSettings tem sua DetectReplays propriedade definida como false.

Caso contrário, um SymmetricSecurityBindingElement será retornado, com definido como RequireSignatureConfirmationfalse.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.

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

Um SecurityBindingElement que contém uma especificação sobre como as mensagens de handshake de conversa segura são protegidas.

requireCancellation

Boolean

true se o cancelamento for necessário; caso contrário, false. Definir esse parâmetro como false habilita um token de contexto de segurança útil em cenários de Web farm, porque, nesse modo, o estado de sessão é codificado dentro do token de contexto de segurança estabelecido, em vez de manter na memória do servidor.

Retornos

SecurityBindingElement

Um objeto SecurityBindingElement.

Exceções

ArgumentNullException

bootstrapSecurity é null.

Exemplos

O código a seguir mostra como chamar esse método.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

Comentários

Se requireCancellation for false, os tokens de contexto de segurança baseados em cookie serão emitidos; caso contrário, os tokens de contexto de segurança baseados em sessão serão emitidos.

O bootstrapSecurity é usado para indicar a associação de segurança e a política usadas para solicitar um SecureConversationToken do serviço.

Se bootstrapSecurity for um TransportSecurityBindingElement, o elemento de associação retornado por esse método também é um TransportSecurityBindingElemente IncludeTimestamp é definido truecomo ; e o LocalClientSecuritySettings objeto retornado de LocalClientSettings tem sua DetectReplays propriedade definida como false; e o LocalServiceSecuritySettings objeto retornado de LocalServiceSettings tem sua DetectReplays propriedade definida como false.

Caso contrário, um SymmetricSecurityBindingElement será retornado, com definido como RequireSignatureConfirmationfalse.

Observação

Quando a representação for necessária no Windows XP, use uma sessão segura sem um token de contexto de segurança. Quando tokens de contexto de segurança são usados com representação, um InvalidOperationException é gerado. Para obter mais informações, confira Cenários sem suporte. Para obter mais informações sobre sessões seguras, consulte Sessões seguras.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Source:

SecurityBindingElement.cs

Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.

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

Um SecurityBindingElement que contém uma especificação sobre como as mensagens de handshake de conversa segura são protegidas.

requireCancellation

Boolean

true se o cancelamento for necessário; caso contrário, false. Definir esse parâmetro como false habilita um token de contexto de segurança útil em cenários de Web farm, porque, nesse modo, o estado de sessão é codificado dentro do token de contexto de segurança estabelecido, em vez de manter na memória do servidor.

bootstrapProtectionRequirements

ChannelProtectionRequirements

O objeto ChannelProtectionRequirements que especifica os requisitos para a proteção de canal.

Retornos

SecurityBindingElement

Um objeto SecurityBindingElement.

Exceções

ArgumentNullException

bootstrapSecurity é null.

Comentários

O bootstrapProtectionRequirements parâmetro permite a personalização de como as mensagens trocadas como parte do handshake de conversa segura são protegidas.

O bootstrapSecurity é usado para indicar a associação de segurança e a política usadas para solicitar um token de conversa segura do serviço.

Se bootstrapSecurity for um TransportSecurityBindingElement, o elemento de associação retornado por esse método também é um TransportSecurityBindingElemente IncludeTimestamp é definido truecomo ; e o LocalClientSecuritySettings objeto retornado de LocalClientSettings tem sua DetectReplays propriedade definida como false; e o LocalServiceSecuritySettings objeto retornado de LocalServiceSettings tem sua DetectReplays propriedade definida como false.

Caso contrário, um SymmetricSecurityBindingElement será retornado, com definido como RequireSignatureConfirmationfalse.

Observação

Quando a representação for necessária no Windows XP, use uma sessão segura sem um token de contexto de segurança. Quando tokens de contexto de segurança são usados com representação, um InvalidOperationException é gerado. Para obter mais informações, confira Cenários sem suporte. Para obter mais informações sobre sessões seguras, consulte Sessões seguras.