方法: セキュリティ モードを設定する

Windows Communication Foundation (WCF) のセキュリティには、トランスポート、メッセージ、"メッセージ資格情報付きトランスポート" という 3 つの共通のセキュリティ モードがあり、ほとんどの定義済みバインディングで使用されています。これ以外に、2 つのバインディングに固有の 2 つのモードがあります。BasicHttpBinding の "トランスポート資格情報専用" モードと、NetMsmqBinding の "両方" モードです。 ここでは、3 つの共通のセキュリティモードである 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
   

   または、モードを Message (メッセージ) に設定します。コードは次のようになります。

   WSHttpBinding b = new WSHttpBinding();
   b.Security.Mode = SecurityMode.Message;
   

   Dim b As New WSHttpBinding()
   b.Security.Mode = SecurityMode.Message
   

   または、モードを TransportWithMessageCredential (メッセージ資格情報付きトランスポート) に設定します。コードは次のようになります。

   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 プロパティの設定

モードを上記の 3 つの値のいずれかに設定すると、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
   

構成でモードと 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 プロトコルでは SSL (Secure Sockets Layer) over HTTP (HTTPS) を使用します。 このため、トランスポート セキュリティ オブジェクト (ClientCredentialType など) の HttpTransportSecurity プロパティを設定しても無視されます。 つまり、メッセージ セキュリティ オブジェクト (ClientCredentialType バインディングの場合は WSHttpBinding オブジェクト) の NonDualMessageSecurityOverHttp だけを設定できます。

詳細については、「方法: トランスポート セキュリティとメッセージ資格情報を使用する」を参照してください。

関連項目

• 方法: SSL 証明書を使用してポートを構成する
• 方法: トランスポート セキュリティとメッセージ資格情報を使用する
• トランスポート セキュリティ
• メッセージのセキュリティ
• セキュリティの概要
• システム標準のバインディング
• <security>
• <security>
• <security>