語言
Windows 通訊基礎(WCF)安全有三種常見的安全模式,這些模式在大多數預設綁定中都有:傳輸、訊息,以及「帶訊息憑證的傳輸」。另外兩種模式專門針對兩種綁定:一種是「 BasicHttpBinding僅傳輸憑證」模式,位於 ,以及「兩者」模式,分別位於 NetMsmqBinding。 然而,本主題主要聚焦於三種常見的安全模式: Transport、、 Message和 TransportWithMessageCredential。
請注意,並非所有預設綁定都支援所有這些模式。 本主題將使用WSHttpBinding和NetTcpBinding類別設定模式,並示範如何通過程式化和配置方式來設定模式。
欲了解更多資訊,請參閱 WCF 安全性、 安全概述、 保障服務及 保障服務與客戶。 欲了解更多關於傳輸模式與訊息的資訊,請參閱 傳輸安全 與 訊息安全。
在程式碼中設定安全模式
建立一個你正在使用的綁定類別的實例。 關於預先定義的綁定清單,請參見 System-Provided 綁定。 此範例建立一個類別的 WSHttpBinding 實例。
設定
Mode由Security屬性所回傳物件的屬性。WSHttpBinding b = new WSHttpBinding(); b.Security.Mode = SecurityMode.Transport;Dim b As New WSHttpBinding() b.Security.Mode = SecurityMode.Transport或者,將模式設為訊息,如以下程式碼所示。
WSHttpBinding b = new WSHttpBinding(); b.Security.Mode = SecurityMode.Message;Dim b As New WSHttpBinding() b.Security.Mode = SecurityMode.Message或者將傳輸模式設為帶有訊息憑證,如以下程式碼所示。
WSHttpBinding b = new WSHttpBinding(); b.Security.Mode = SecurityMode.TransportWithMessageCredential;Dim b As New WSHttpBinding() b.Security.Mode = SecurityMode.TransportWithMessageCredential你也可以在綁定的建構子中設定模式,如下程式碼所示。
WSHttpBinding b = new WSHttpBinding(SecurityMode.Message);Dim b As New WSHttpBinding(SecurityMode.Message)
設定 ClientCredentialType 屬性
將模式設定為三個值之一,決定你如何設定屬性 ClientCredentialType 。 例如,使用WSHttpBinding類別,將模式設定為Transport表示你必須將HttpTransportSecurity類別的ClientCredentialType屬性設為適當的值。
設定 ClientCredentialType 屬性以設定傳輸模式
建立一個繫結的實例。
將
Mode屬性設為Transport。將屬性設定
ClientCredential為適當的值。 以下程式碼將屬性設定為Windows。WSHttpBinding b = new WSHttpBinding(); b.Security.Mode = SecurityMode.Transport; b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Windows;Dim b As New WSHttpBinding() b.Security.Mode = SecurityMode.Transport b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Windows
設定用於訊息模式的 ClientCredentialType 屬性
建立綁定實例。
將
Mode屬性設為Message。將屬性設定
ClientCredential為適當的值。 以下程式碼將屬性設定為Certificate。WSHttpBinding b = new WSHttpBinding(); b.Security.Mode = SecurityMode.Message; b.Security.Message.ClientCredentialType = MessageCredentialType.Certificate;Dim b As New WSHttpBinding() b.Security.Mode = SecurityMode.Message b.Security.Message.ClientCredentialType = MessageCredentialType.Certificate
在配置中設定 Mode 和 ClientCredentialType 屬性
在設定檔的<bindings>元素中加入適當的綁定元素。 以下範例新增了一個 <wsHttpBinding> 元素。
新增一個
<binding>元素,並將其name屬性設為適當的值。新增一個
<security>元素並將屬性設mode為Message、Transport、 或TransportWithMessageCredential。若模式設定為
Transport,則加入元素<transport>並將屬性設clientCredential為適當的值。以下範例將模式設為「
Transport",然後將元素屬性clientCredentialType設<transport>為「Windows"」。<wsHttpBinding> <binding name="TransportSecurity"> <security mode="Transport" > <transport clientCredentialType = "Windows" /> </security> </binding> </wsHttpBinding >或者,將
security mode設為「Message"」,然後接著一個<"message">元素。 此範例將 設clientCredentialType為 。Certificate"<wsHttpBinding> <binding name="MessageSecurity"> <security mode="Message" > <message clientCredentialType = "Certificate" /> </security> </binding> </wsHttpBinding >使用該 TransportWithMessageCredential 值是特例,以下將說明。
使用 TransportWithMessageCredential
當將安全模式設定為 TransportWithMessageCredential時,傳輸決定實際提供傳輸層安全性的機制。 例如,HTTP 協定使用基於 HTTP (HTTPS) 的安全套接字層(SSL)。 因此,設定 ClientCredentialType 任何傳輸安全物件(例如 HttpTransportSecurity)的屬性會被忽略。 換句話說,你只能設定訊息安全物件(對於WSHttpBinding綁定,則是NonDualMessageSecurityOverHttp物件)的ClientCredentialType。
欲了解更多資訊,請參閱 《如何使用傳輸安全與訊息憑證》。