このセクションでは、.NET WCF SOAP クライアントに関するよくある質問に回答します。

このセクションの内容:

バインディングとは何か

WCF のバインディングとは、Web サービス エンドポイントのトランスポート、セキュリティ、およびメッセージ エンコーディングを記述するものです。SOAP Client がエンドポイントと通信するためには、エンドポイントのバインディングがわかっていなければなりません。SOAP Client は WSDL ドキュメントまたは .NET WCF クライアント構成ファイルから自動的にバインディングを判断します。

.NET WCF クライアント構成ファイルを作成するには、どうすればよいのか

Microsoft Service Model Metadata Tool (svcutil.exe) は、サービスの WSDL ドキュメントの URL を指定すると、クライアント構成ファイルを生成します。Microsoft Service Configuration Editor を使用すると、グラフィカルなユーザー インターフェイスから WCF 構成ファイルを作成し、編集することができます。どちらのツールも Visual Studio に付属する Microsoft Windows SDK に含まれているほか、Microsoft の Web サイトからダウンロードできます。Web サービスの開発者からテスト対象の Web サービスのクライアント構成ファイルの提供を受けることが可能な場合もあるでしょう。

.NET WCF クライアント構成ファイルは使用する必要があるのか

必須ではありません。Web サービスの WSDL ドキュメントに適切にサービスが記述されていれば、クライアント構成ファイルを使用せずに、SOAP Client が WSDL に従うよう指定するだけで構いません。ただし、Web サービスが証明書ベースの認証を使用する場合は、.NET WCF クライアント構成ファイルをセットアップし、証明書がインストールされたローカル マシン上の場所を記述する必要があります。WCF バインディングは、受信メッセージの最大サイズなど、さまざまな制限も定義します。.NET クライアント構成ファイルを使用すると、そのような制限をコントロールすることができます。

証明書ベースの認証を構成するには、どうすればよいのか

まず、Windows Certificate Manager を使用してクライアント証明書およびサーバー証明書をインストールする必要があります。Windows Certificate Manger を開くには、[スタート] メニューの [Run...] をクリックして "certmgr.msc" と入力し、[OK] をクリックします。通常、サーバーの証明書は [信頼されたユーザー] ストアにインストールし、クライアント証明書は [個人] ストアにインストールします。次に、これらの証明書の場所をクライアント構成ファイルに指定します。 

MSDN の Web サイトには、この手順の詳細のほか、構成ファイルのサンプルが記載されています。

• 証明書の使用: http://msdn.microsoft.com/en-us/library/ms731899.aspx 
• 方法 : クライアントの資格情報の値を指定する:  http://msdn.microsoft.com/en-us/library/ms732391.aspx 
• トランスポート セキュリティと証明書認証: http://msdn.microsoft.com/en-us/library/ms731074.aspx 
• メッセージ セキュリティと証明書クライアント: http://msdn.microsoft.com/en-us/library/ms733098.aspx 

古い .NET web サービスを使用して .NET WCF SOAP クライアントをテストできるか

WSE 3.0 のみ。WSE 3.0 のサービスとネットワークレベルで互換性があるのは、WSE 3.0. .NET WCF クライアントだけです。次のカスタム バインディングを使用すると、Secure Conversation および MutualCertificate11 を使用する WSE 3.0 の Web サービスをテストできます。

<binding name="SecureConversationMutualCertificate11SignEncryptConfig">
    <security authenticationMode="SecureConversation" messageProtectionOrder=
         "SignBeforeEncrypt" requireSecurityContextCancellation="false">
         <secureConversationBootstrap authenticationMode="MutualCertificate"
               securityHeaderLayout="Strict" messageProtectionOrder="SignBeforeEncrypt"
               requireSignatureConfirmation="true" />
    </security>
    <textMessageEncoding messageVersion="Soap11WSAddressingAugust2004" />
    <httpTransport />
</binding>

MSDN の Web サイトにより詳細な情報が記載されています: http://msdn2.microsoft.com/en-us/library/ms730299.aspx

.NET WCF SOAP クライアントを使用してGlassfish Metro/WSIT ベースのサービスをテストできるか

できます。Metro WSIT サービスは、SOAtest の SOAP Client ツールを含む .NET WCF クライアントと相互運用性があります。ただし、Metro には既知のバグがあり、空白および改行があると、リクエスト メッセージのセキュリティ検証が失敗します。この問題を回避するには、SOAP Client テストのリクエスト SOAP エンベロープ出力に Extension ツールを連結し、余分な空白を削除します。

from com.parasoft.api import * 
from java.lang import *
 
def removeAllNewLineCharacters(input, context):
    noNewLines = str(input).replace("\r", "").replace("\n", "")
    result = String(noNewLines).replaceAll(">\s*<", "><")
    Application.showMessage(result) # for debugging
    return result

よく見られるエラー