<messageSenderAuthentication> 元素

  • 项目

指定用于对等消息发送方的身份验证选项。

有关对等编程详细信息，请参阅对等网络。

configuration
  system.serviceModel
    behaviors
      endpointBehaviors
        behavior
          <clientCredentials>
            <peer>
              <messageSenderAuthentication>

语法

<messageSenderAuthentication customCertificateValidatorType= "namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"
                             certificateValidationMode = "ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"
                             revocationMode="NoCheck/Online/Offline"
                             trustedStoreLocation="CurrentUser/LocalMachine" />

特性和元素

以下几节描述了特性、子元素和父元素。

特性

属性 说明
customCertificateValidatorType 一个用于验证自定义类型的类型和程序集。 当 certificateValidationMode 设置为 Custom 时，必须设置此属性。
certificateValidationMode 指定用来验证凭据的三种模式之一。 如果设置为 Custom，则还必须提供 customCertificateValidator。
revocationMode 用于检查吊销证书列表 (CRL) 的一种模式。
trustedStoreLocation 两个系统存储位置之一：LocalMachine 或 CurrentUser。 在向客户端协商服务证书时使用此值。 验证会针对指定的存储位置中的受信任人存储来执行。

customCertificateValidatorType 属性

值 说明
字符串 可选。 指定类型名称和程序集以及用于查找类型的其他数据。 至少需要命名空间和类型名称。 可选信息包括：程序集名称、版本号、区域性和公钥标记。

certificateValidationMode 属性

值 说明
枚举 可选。 下列值之一：None、PeerTrust、ChainTrust、PeerOrChainTrust 和 Custom。 默认值为 ChainTrust。 默认值为 ChainTrust。

有关详细信息，请参阅使用证书。

revocationMode 属性

值 说明
枚举 下列值之一：NoCheck、Online 和 Offline。 默认值为 Online。

有关详细信息，请参阅使用证书。

trustedStoreLocation 属性

值 说明
枚举 以下值之一：LocalMachine 或 CurrentUser。 默认为 CurrentUser。 如果客户端应用程序在系统帐户下运行，则证书通常位于 LocalMachine。 如果客户端应用程序在用户帐户下运行，则证书通常位于 CurrentUser。 默认值为 CurrentUser。

子元素

无。

父元素

元素 说明
<peer> 指定一个用于向对等服务证明客户端身份的凭据。

备注

如果选择了消息身份验证，则必须配置此元素。 对于输出通道，对每个消息均使用 <certificate> 提供的证书进行签名。 在将任一消息传递到应用程序之前，都会使用由此元素的 customCertificateValidatorType 属性指定的验证程序对照消息凭据对其进行检查。 验证程序可以接受或拒绝凭据。

示例

下面的代码将消息发送方验证模式设置为 PeerOrChainTrust。

<behaviors>
  <endpointBehaviors>
    <behavior name="MyEndpointBehavior">
      <clientCredentials>
        <peer>
          <certificate findValue="www.contoso.com"
                       storeLocation="LocalMachine"
                       x509FindType="FindByIssuerName" />
          <messageSenderAuthentication certificateValidationMode="PeerOrChainTrust" />
          <messageSenderAuthentication certificateValidationMode="None" />
        </peer>
      </clientCredentials>
    </behavior>
  </endpointBehaviors>
</behaviors>

请参阅