語言

如何設定安全模式

Windows 通訊基礎(WCF)安全有三種常見的安全模式,這些模式在大多數預設綁定中都有:傳輸、訊息,以及「帶訊息憑證的傳輸」。另外兩種模式專門針對兩種綁定:一種是「 BasicHttpBinding僅傳輸憑證」模式,位於 ,以及「兩者」模式,分別位於 NetMsmqBinding。 然而,本主題主要聚焦於三種常見的安全模式: Transport、、 Message和 TransportWithMessageCredential。

請注意,並非所有預設綁定都支援所有這些模式。 本主題將使用WSHttpBinding和NetTcpBinding類別設定模式,並示範如何通過程式化和配置方式來設定模式。

欲了解更多資訊,請參閱 WCF 安全性、 安全概述、 保障服務及 保障服務與客戶。 欲了解更多關於傳輸模式與訊息的資訊,請參閱 傳輸安全 與 訊息安全。

在程式碼中設定安全模式

  1. 建立一個你正在使用的綁定類別的實例。 關於預先定義的綁定清單,請參見 System-Provided 綁定。 此範例建立一個類別的 WSHttpBinding 實例。

  2. 設定 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
    
  3. 你也可以在綁定的建構子中設定模式,如下程式碼所示。

    WSHttpBinding b = new WSHttpBinding(SecurityMode.Message);
    
    Dim b As New WSHttpBinding(SecurityMode.Message)
    

設定 ClientCredentialType 屬性

將模式設定為三個值之一,決定你如何設定屬性 ClientCredentialType 。 例如,使用WSHttpBinding類別,將模式設定為Transport表示你必須將HttpTransportSecurity類別的ClientCredentialType屬性設為適當的值。

設定 ClientCredentialType 屬性以設定傳輸模式

  1. 建立一個繫結的實例。

  2. 將 Mode 屬性設為 Transport。

  3. 將屬性設定 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 屬性

  1. 建立綁定實例。

  2. 將 Mode 屬性設為 Message。

  3. 將屬性設定 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 屬性

  1. 在設定檔的<bindings>元素中加入適當的綁定元素。 以下範例新增了一個 <wsHttpBinding> 元素。

  2. 新增一個 <binding> 元素,並將其 name 屬性設為適當的值。

  3. 新增一個 <security> 元素並將屬性設 mode 為 Message、 Transport、 或 TransportWithMessageCredential。

  4. 若模式設定為 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。

欲了解更多資訊,請參閱 《如何使用傳輸安全與訊息憑證》。

另請參閱