共用方式為

<certificate> 項目

  • 發行項

指定要用來簽署與加密對等用戶端之訊息的 X.509 憑證。

結構描述階層

<system.serviceModel>
  <behaviors>
    <endpointBehaviors>
      <endpointBehaviors> 的 <behavior>
        <clientCredentials>
          <clientCredentials> 項目的 <peer>
            <certificate> 項目

語法

<certificate 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) 的憑證存放區。

  • CertificateAuthority：中繼憑證授權單位 (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。

項目子系

無。

父項目

項目 描述

<clientCredentials> 項目的 <peer>

指定驗證對等用戶端時所使用的認證。

備註

這個組態項目包含在驗證對等網狀結構中鄰接項目時所使用的 X509Certificate2 執行個體。

如需對等程式設計的詳細資訊，請參閱Peer to Peer Networking。

範例

下列程式碼說明如何尋找對等案例中使用的憑證。

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

另請參閱

參考

PeerCredentialElement
Certificate
X509PeerCertificateElement
Certificate

其他資源

Working with Certificates
Peer to Peer Networking
Peer Channel Message Authentication
Peer Channel Custom Authentication
Best Practices for Securing PeerChannel Applications