<serviceCredentials> 的 <serviceCertificate>

  • 项目

指定一个 X.509 证书，以供服务用来向使用 Message 安全模式的客户端证明自己的身份。

configuration
  system.serviceModel
    behaviors
      <serviceBehaviors>
        behavior
          <serviceCredentials>
            <serviceCertificate>

语法

<serviceCertificate findValue="String"
                    storeLocation="LocalMachine/CurrentUser"
                    storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"
                    x509FindType="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 说明
findValue 一个字符串，包含要在 X.509 证书存储中搜索的值。 此属性中包含的类型必须满足指定 X509FindType 的需求。 默认值为空字符串。
storeLocation 指定客户端可用于验证服务器证书的 X.509 证书存储的位置。 有效值包括以下值：

- LocalMachine：分配给本地计算机的证书存储区。
- CurrentUser：分配给当前用户的证书存储区。

默认值为 LocalMachine。
storeName 指定要打开的 X.509 证书存储区的名称。 有效值包括以下值：

- AddressBook：其他用户的证书存储。
- AuthRoot：第三方证书颁发机构 (CA) 的证书存储区。
- CertificatAuthority：中间证书颁发机构 (CA) 的证书存储。
- Disallowed：已吊销证书的证书存储区。
- My：个人证书的证书存储区。
- Root：受信任根证书颁发机构 (CA) 的证书存储区。
- TrustedPeople：直接受信任的人员和资源的证书存储区。
- TrustedPublisher：直接受信任的发行者的证书存储区。

默认值为 My。
x509FindType 定义要执行的 X.509 搜索的类型。 有效值包括以下值：

- FindByThumbprint
- FindBySubjectName
- FindBySubjectDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTemplateName
- FindByApplicationPolicy
- FindByCertificatePolicy
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier

findValue 属性中包含的类型必须满足指定 X509FindType 的要求。

默认值为 FindBySubjectDistinguishedName。

子元素

无

父元素

元素 说明
<serviceCredentials> 指定要用于对服务进行身份验证的凭据以及与客户端凭据验证相关的设置。

注解

使用此元素可指定一个 X.509 证书，以供服务用来向使用 Message 安全模式的客户端证明自己的身份。 如果您使用的是将会定期续订的证书，则证书的指纹将会变更。 在此情况下，请使用主题名称作为 x509FindType，因为可以使用同一主题名称来重新颁发该证书。

有关使用元素的详细信息，请参阅如何：指定客户端凭据值。

另请参阅