<certificate> 元素
指定要用來簽署與加密對等用戶端之訊息的 X.509 憑證。
<configuration>
<system.serviceModel>
<behaviors>
<endpointBehaviors>
<behavior>
<clientCredentials>
<peer>
<certificate>
Syntax
<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。 |
子元素
無。
父項目
| 元素 | 描述 |
|---|---|
| <同儕節點> | 指定驗證對等用戶端時所使用的認證。 |
備註
這個組態項目包含在驗證對等網狀結構中鄰接項目時所使用的 X509Certificate2 執行個體。
如需對等程式設計的詳細資訊，請參閱對等網路。
範例
下列程式碼說明如何尋找對等案例中使用的憑證。
<behaviors>
<endpointBehaviors>
<behavior name="MyEndpointBehavior">
<clientCredentials>
<peer>
<certificate findValue="www.contoso.com"
storeLocation="LocalMachine"
x509FindType="FindByIssuerName" />
</peer>
</clientCredentials>
</behavior>
</endpointBehaviors>
</behaviors>
