<serviceCertificate> 元素的 <authentication>

项目
06/08/2023

指定客户端代理用于对使用 SSL/TLS 协商获取的服务证书进行身份验证的设置。

configuration
  system.serviceModel
    behaviors
      endpointBehaviors
        behavior
          <clientCredentials>
            <serviceCertificate>
              <authentication>

语法

<authentication customCertificateValidatorType="String"
                certificateValidationMode="None/PeerTrust/ChainTrust/PeerOrChainTrust/Custom"
                revocationMode="NoCheck/Online/Offline"
                trustedStoreLocation="LocalMachine/CurrentUser" />

特性和元素

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

特性

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

customCertificateValidator 属性

值	说明
String	指定类型名称和程序集以及用于查找类型的其他数据。

certificateValidationMode 属性

值	说明
枚举	下列值之一：None、PeerTrust、ChainTrust、PeerOrChainTrust 和 Custom。有关详细信息，请参阅使用证书。

revocationMode 属性

值	说明
枚举	下列值之一：NoCheck、Online 和 Offline。有关详细信息，请参阅使用证书。

trustedStoreLocation 属性

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

子元素

无。

父元素

元素	说明
<serviceCertificate>	指定客户端对服务进行身份验证时使用的证书。

注解

此配置元素的 certificateValidationMode 属性指定用于对证书进行身份验证的信任级别。默认情况下，该级别设置为 ChainTrust，它指定每个证书都必须存在于某个证书层次结构中，而该层次结构以位于证书链顶端的受信任的证书颁发机构结束。这是最安全的模式。您还可以将此值设置为 PeerOrChainTrust，该值指定受信任的链中的证书以及自行颁发的证书（对等信任）都被接受。因为不需要从受信任的证书颁发机构那里购买自行颁发的证书，所以可以在开发和调试客户端和服务时使用此值。在部署客户端时，请改用 ChainTrust 值。您也可以将该值设置为 Custom 或 None。若要使用 Custom 值，还必须将 customCertificateValidator 属性设置为程序集和用于验证证书的类型。若要创建您自己的自定义验证程序，必须从 X509CertificateValidator 抽象类进行继承。有关详细信息，请参见如何：创建使用自定义证书验证程序的服务。

revocationMode 属性指定检查证书是否已吊销的方式。默认值为 online，指示将自动检查证书是否已吊销。有关详细信息，请参阅使用证书。

示例

以下示例执行两项任务。它首先指定一个服务证书，以供客户端在通过 HTTP 协议与域名为 www.contoso.com 的终结点通信时使用。然后，它指定了在身份验证过程中使用的吊销模式和存储位置。

<serviceCertificate>
  <defaultCertificate findValue="www.contoso.com"
                      storeLocation="LocalMachine"
                      storeName="TrustedPeople"
                      x509FindType="FindByIssuerDistinguishedName" />
  <scopedCertificates>
     <add targetUri="http://www.contoso.com"
          findValue="www.contoso.com"
          storeLocation="LocalMachine"
          storeName="Root"
          x509FindType="FindByIssuerName" />
  </scopedCertificates>
  <authentication revocationMode="Online"
                  trustedStoreLocation="LocalMachine" />
</serviceCertificate>