SecurityBindingElement.CreateSecureConversationBindingElement Método

Definição

Cria um elemento de associação de segurança simétrica configurado para estabelecer uma conversa segura entre o cliente e o serviço.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages.

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.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

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.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages.

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.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

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.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

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.A SecurityBindingElement that contains specification on how the secure conversation handshake messages are secured.

Retornos

SecurityBindingElement

Um objeto SecurityBindingElement.A SecurityBindingElement object.

Exceções

bootstrapSecurity é null.bootstrapSecurity is null.

Comentários

O elemento Binding é configurado para usar tokens de contexto de segurança baseados em sessão.The binding element is configured to use session-based security context tokens.

O bootstrapSecurity é usado para indicar a associação de segurança e a política usada para solicitar um token de conversa seguro do serviço.The bootstrapSecurity is used to indicate the security binding and policy used to request a secure conversation token from the service.

Se bootstrapSecurity for a TransportSecurityBindingElement , o elemento Binding retornado por esse método também será um e IncludeTimestamp será definido como true ; e o LocalClientSecuritySettings objeto retornado de LocalClientSettings terá sua DetectReplays propriedade definida como false ; e o LocalServiceSecuritySettings objeto retornado de LocalServiceSettings terá sua DetectReplays propriedade definida como false .If bootstrapSecurity is a TransportSecurityBindingElement, the binding element returned by this method is also one, and IncludeTimestamp is set to true; and the LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false; and the LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

Caso contrário, um SymmetricSecurityBindingElement será retornado, com RequireSignatureConfirmation definido como false .Otherwise, a SymmetricSecurityBindingElement is returned, with RequireSignatureConfirmation set to false.

Aplica-se a

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.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages.

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.A SecurityBindingElement that contains specification on how the secure conversation handshake messages are secured.

requireCancellation
Boolean

true se o cancelamento for necessário; caso contrário, false.true if cancellation is required; otherwise, 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.Setting this parameter to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.

Retornos

SecurityBindingElement

Um objeto SecurityBindingElement.A SecurityBindingElement object.

Exceções

bootstrapSecurity é null.bootstrapSecurity is null.

Exemplos

O código a seguir mostra como chamar esse método.The following code shows how to call this method.

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 cookies serão emitidos; caso contrário, os tokens de contexto de segurança baseados em sessão serão emitidos.If requireCancellation is false, cookie-based security context tokens are issued; otherwise, session-based security context tokens are issued.

O bootstrapSecurity é usado para indicar a associação de segurança e a política usada para solicitar um SecureConversationToken do serviço.The bootstrapSecurity is used to indicate the security binding and policy used to request a SecureConversationToken from the service.

Se bootstrapSecurity for a TransportSecurityBindingElement , o elemento de associação retornado por esse método também será um TransportSecurityBindingElement 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 .If bootstrapSecurity is a TransportSecurityBindingElement, the binding element returned by this method is also a TransportSecurityBindingElement, and IncludeTimestamp is set to true; and the LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false; and the LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

Caso contrário, um SymmetricSecurityBindingElement será retornado, com RequireSignatureConfirmation definido como false .Otherwise, a SymmetricSecurityBindingElement is returned, with RequireSignatureConfirmation set to false.

Observação

Quando a representação é necessária no Windows XP, use uma sessão segura sem um token de contexto de segurança.When impersonation is required on Windows XP, use a secure session without a security context token. Quando os tokens de contexto de segurança são usados com a representação, um InvalidOperationException é gerado.When security context tokens are used with impersonation an InvalidOperationException is thrown. Para obter mais informações, consulte cenários sem suporte.For more information, see Unsupported Scenarios. Para obter mais informações sobre sessões seguras, consulte proteger sessões.For more information about secure sessions, see Secure Sessions.

Aplica-se a

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.Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. O token do contexto de segurança emitido no fim do handshake de conversa segura é usado para proteger as mensagens.The security context token issued at the end of the secure conversation handshake is used to secure the messages. O elemento de associação de segurança de bootstrap especifica como as mensagens de handshake de conversa segura são protegidas.The bootstrap security binding element specifies how the secure conversation handshake messages are secured.

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.A SecurityBindingElement that contains specification on how the secure conversation handshake messages are secured.

requireCancellation
Boolean

true se o cancelamento for necessário; caso contrário, false.true if cancellation is required; otherwise, 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.Setting this parameter to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.

bootstrapProtectionRequirements
ChannelProtectionRequirements

O objeto ChannelProtectionRequirements que especifica os requisitos para a proteção de canal.The ChannelProtectionRequirements object that specifies the requirements for channel protection.

Retornos

SecurityBindingElement

Um objeto SecurityBindingElement.A SecurityBindingElement object.

Exceções

bootstrapSecurity é null.bootstrapSecurity is 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.The bootstrapProtectionRequirements parameter enables customization of how the messages exchanged as part of the secure conversation handshake are secured.

O bootstrapSecurity é usado para indicar a associação de segurança e a política usada para solicitar um token de conversa seguro do serviço.The bootstrapSecurity is used to indicate the security binding and policy used to request a secure conversation token from the service.

Se bootstrapSecurity for a TransportSecurityBindingElement , o elemento de associação retornado por esse método também será um TransportSecurityBindingElement 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 .If bootstrapSecurity is a TransportSecurityBindingElement, the binding element returned by this method is also a TransportSecurityBindingElement, and IncludeTimestamp is set to true; and the LocalClientSecuritySettings object returned from LocalClientSettings has its DetectReplays property set to false; and the LocalServiceSecuritySettings object returned from LocalServiceSettings has its DetectReplays property set to false.

Caso contrário, um SymmetricSecurityBindingElement será retornado, com RequireSignatureConfirmation definido como false .Otherwise, a SymmetricSecurityBindingElement is returned, with RequireSignatureConfirmation set to false.

Observação

Quando a representação é necessária no Windows XP, use uma sessão segura sem um token de contexto de segurança.When impersonation is required on Windows XP, use a secure session without a security context token. Quando os tokens de contexto de segurança são usados com a representação, um InvalidOperationException é gerado.When security context tokens are used with impersonation an InvalidOperationException is thrown. Para obter mais informações, consulte cenários sem suporte.For more information, see Unsupported Scenarios. Para obter mais informações sobre sessões seguras, consulte proteger sessões.For more information about secure sessions, see Secure Sessions.

Aplica-se a