作法：設定安全性模式

  • 發行項

Windows Communication Foundation (WCF) 安全性具有三種常見的安全性模式，可在下列最預先定義的繫結中找到：傳輸、訊息與「使用訊息認證進行傳輸」。另外有兩種額外的模式適用於下列兩種繫結：BasicHttpBinding 上的「僅限傳輸-認證」以及 NetMsmqBinding 上的「兩者並存」模式。 然而，此主題將著重在三種常見的安全性模式：Transport、Message 與 TransportWithMessageCredential。

請注意，並非所有預先定義的繫結都支援這些模式。 本主題將使用 WSHttpBinding 和 NetTcpBinding 類別來設定模式，並示範如何以程式設計方式及透過組態來設定模式。

如需詳細資訊，請參閱 WCF 安全性、安全性概觀、保護服務的安全，以及確保服務與用戶端的安全。 如需傳輸模式和訊息的詳細資訊，請參閱傳輸安全性和訊息安全性。

若要在程式碼中設定安全性模式

  1. 針對您正在使用的繫結類別建立執行個體。 如需預先定義的繫結清單，請參閱系統提供的繫結。 下列範例會建立 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 時，代表您必須將 ClientCredentialType 類別的 HttpTransportSecurity 屬性設為適當值。

若要設定傳輸模式的 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 通訊協定會使用 Secure Sockets Layer (SSL) over HTTP (HTTPS)。 因此，會忽略對任何傳輸安全性物件 (例如 ClientCredentialType) 的 HttpTransportSecurity 屬性設定。 換句話說，您只能設定訊息安全性物件的 ClientCredentialType (對 WSHttpBinding 繫結程序來說，指的是 NonDualMessageSecurityOverHttp 物件)。

如需詳細資訊，請參閱操作說明：使用傳輸安全性和訊息認證。

另請參閱