SecurityBindingElement.CreateSecureConversationBindingElement 方法

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Security.dll

程序集:

System.ServiceModel.dll

创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。

重载

CreateSecureConversationBindingElement(SecurityBindingElement)	创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。

CreateSecureConversationBindingElement(SecurityBindingElement)

创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。

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

参数

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement 包含如何保护安全对话握手消息的规范。

返回

SecurityBindingElement

SecurityBindingElement 对象。

例外

ArgumentNullException

bootstrapSecurity 为 null。

注解

配置绑定元素以使用基于会话的安全上下文令牌。

bootstrapSecurity 用于指示安全绑定和策略，该绑定和策略用于向服务请求安全对话令牌。

如果 bootstrapSecurity 是 TransportSecurityBindingElement，则由此方法返回的绑定元素也是它，且 IncludeTimestamp 设置为 true；而且从 LocalClientSecuritySettings 返回的 LocalClientSettings 对象的 DetectReplays 属性设置为 false；而且从 LocalServiceSecuritySettings 返回的 LocalServiceSettings 对象的 DetectReplays 属性设置为 false。

否则将返回 SymmetricSecurityBindingElement，并且 RequireSignatureConfirmation 设置为 false。

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。

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

参数

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement 包含如何保护安全对话握手消息的规范。

requireCancellation

Boolean

如果需要取消，则为 true；否则为 false。 将此参数设置为 false 可在网络场方案中启用有用的安全上下文令牌，因为在此模式下，会话状态是在建立的安全上下文令牌内部编码的，而不是保留在服务器内存中。

返回

SecurityBindingElement

SecurityBindingElement 对象。

例外

ArgumentNullException

bootstrapSecurity 为 null。

示例

下面的代码演示如何调用此方法。

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

注解

如果 requireCancellation 为 false，则颁发基于 Cookie 的安全上下文令牌；否则，颁发基于会话的安全上下文令牌。

bootstrapSecurity 用于指示安全绑定和策略，该绑定和策略用于向服务请求 SecureConversationToken。

如果 bootstrapSecurity 是 TransportSecurityBindingElement，则由此方法返回的绑定元素也是 TransportSecurityBindingElement，且 IncludeTimestamp 设置为 true；而且从 LocalClientSecuritySettings 返回的 LocalClientSettings 对象的 DetectReplays 属性设置为 false；而且从 LocalServiceSecuritySettings 返回的 LocalServiceSettings 对象的 DetectReplays 属性设置为 false。

否则将返回 SymmetricSecurityBindingElement，并且 RequireSignatureConfirmation 设置为 false。

备注

在 Windows XP 上需要模拟时，请使用没有安全上下文令牌的安全会话。 如果在模拟时使用安全上下文令牌，则会引发 InvalidOperationException。 有关详细信息，请参阅不支持的方案。 有关安全会话的详细信息，请参阅 安全会话。

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

创建一个对称安全绑定元素，该元素配置为可在客户端和服务之间建立安全的对话。 在安全对话握手结束时颁发的安全上下文令牌用于保护消息的安全。 启动安全绑定元素指定如何保护安全对话握手消息。

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

参数

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement 包含如何保护安全对话握手消息的规范。

requireCancellation

Boolean

如果需要取消，则为 true；否则为 false。 将此参数设置为 false 可在网络场方案中启用有用的安全上下文令牌，因为在此模式下，会话状态是在建立的安全上下文令牌内部编码的，而不是保留在服务器内存中。

bootstrapProtectionRequirements

ChannelProtectionRequirements

指定通道保护的要求的 ChannelProtectionRequirements 对象。

返回

SecurityBindingElement

SecurityBindingElement 对象。

例外

ArgumentNullException

bootstrapSecurity 为 null。

注解

bootstrapProtectionRequirements 参数可启用自定义功能，以自定义如何保护作为保护对话握手组成部分而交换的消息。

bootstrapSecurity 用于指示安全绑定和策略，该绑定和策略用于向服务请求安全对话令牌。

如果 bootstrapSecurity 是 TransportSecurityBindingElement，则由此方法返回的绑定元素也是 TransportSecurityBindingElement，且 IncludeTimestamp 设置为 true；而且从 LocalClientSecuritySettings 返回的 LocalClientSettings 对象的 DetectReplays 属性设置为 false；而且从 LocalServiceSecuritySettings 返回的 LocalServiceSettings 对象的 DetectReplays 属性设置为 false。

否则将返回 SymmetricSecurityBindingElement，并且 RequireSignatureConfirmation 设置为 false。

备注

在 Windows XP 上需要模拟时，请使用没有安全上下文令牌的安全会话。 如果在模拟时使用安全上下文令牌，则会引发 InvalidOperationException。 有关详细信息，请参阅不支持的方案。 有关安全会话的详细信息，请参阅 安全会话。