SecurityBindingElement.CreateMutualCertificateBindingElement 方法

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.dll

创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。

重载

CreateMutualCertificateBindingElement()	创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。
CreateMutualCertificateBindingElement(MessageSecurityVersion)	创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。

注解

客户端必须使用其证书以及服务器证书进行配置。 此服务器必须使用其证书进行配置。

CreateMutualCertificateBindingElement()

创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement();

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement ();

static member CreateMutualCertificateBindingElement : unit -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement () As SecurityBindingElement

返回

SecurityBindingElement

SecurityBindingElement 对象。

示例

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

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

注解

配置绑定，以实现为每个客户端请求生成新的随机对称密钥（为服务器加密），该密钥用于对请求和服务器的回应进行保护。 客户端证书在请求时可用作认可支持令牌。

已实际创建 AsymmetricSecurityBindingElement。

CreateMutualCertificateBindingElement(MessageSecurityVersion)

创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version);

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version);

static member CreateMutualCertificateBindingElement : System.ServiceModel.MessageSecurityVersion -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion) As SecurityBindingElement

参数

version

MessageSecurityVersion

消息安全版本。

返回

SecurityBindingElement

SecurityBindingElement 对象。

例外

ArgumentNullException

version 为 null。

注解

如果版本为 WSSecurity10，则将配置绑定元素以实现客户端请求由其证书签名并使用服务器证书加密。

如果版本为 WSSecurity11，则配置绑定元素，以实现为每个客户端请求生成新的随机对称密钥（为服务器加密），该密钥用于对请求和服务器的回应进行保护。 客户端证书在请求时可用作认可支持令牌。

备注

通过调用此方法创建了 SecurityBindingElement 对象后，MessageSecurityVersion 属性为不可变。 对它调用 set 不会将其改变。

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

创建一个非对称安全绑定元素，该元素配置为需要基于证书的客户端身份验证以及基于证书的服务器身份验证。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version, bool allowSerializedSigningTokenOnReply);

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version, bool allowSerializedSigningTokenOnReply);

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

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion, allowSerializedSigningTokenOnReply As Boolean) As SecurityBindingElement

参数

version

MessageSecurityVersion

消息安全版本。

allowSerializedSigningTokenOnReply

Boolean

在答复时允许序列化签名标记，则为 true；否则为 false。

返回

SecurityBindingElement

SecurityBindingElement 对象。

例外

ArgumentNullException

version 为 null。

注解

allowSerializedSigningTokenOnReply 参数为 true 时，将启用较旧版本 Web Services Enhancements (WSE) 的互操作性。

备注

通过调用此方法创建了 SecurityBindingElement 对象后，MessageSecurityVersion 属性应被视为不可变。 如果修改此值，则可能出现不一致的绑定行为。