エンドポイントのアドレス
すべてのエンドポイントにはこれと関連するアドレスがあり、エンドポイントの検索と識別に使用されます。このアドレスは主にエンドポイントの位置を指定する URI (Uniform Resource Identifier) で構成されます。Windows Communication Foundation (WCF) のプログラミング モデルでは、エンドポイント アドレスは EndpointAddress クラスによって表されます。このクラスには、このエンドポイントとメッセージを交換する他のエンドポイントがエンドポイントを認証できるようにする、オプションの Identity プロパティ、およびサービスに到達するために必要な他の任意の SOAP ヘッダーを定義するオプションの Headers プロパティが含まれます。オプションのヘッダーは、サービス エンドポイントの識別または対話のために、より詳細なアドレス指定情報を提供します。エンドポイントのアドレスは、ネットワーク上では WS-Addressing エンドポイント参照 (EPR) として表されます。
アドレスの URI 構造
ほとんどのトランスポートの URI アドレスは、4 つの部分から構成されます。たとえば、http://www.fabrikam.com:322/mathservice.svc/secureEndpoint という URI は、次の 4 つの部分から構成されます。
- スキーム : http:
- コンピュータ : www.fabrikam.com
- (省略可能) ポート : 322
- パス : /mathservice.svc/secureEndpoint
サービスのアドレスの定義
サービスのエンドポイント アドレスは、コードを使用して命令的に、または構成を通じて宣言的に指定できます。設置済みサービスのバインディングおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。一般に、サービス エンドポイントの定義にはコードではなく、構成を使用する方がより実用的です。バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。
構成によるアドレス定義
構成ファイルでエンドポイントを定義するには、<endpoint> 要素を使用します。使用例と詳細については、「エンドポイント アドレスの指定」を参照してください。
コードによるアドレス定義
エンドポイント アドレスは、コードで EndpointAddress クラスを使用して作成できます。使用例と詳細については、「エンドポイント アドレスの指定」を参照してください。
WSDL のエンドポイント
エンドポイント アドレスは、対応するエンドポイントの wsdl:port 要素内の WS-Addressing EPR 要素として WSDL で表すこともできます。EPR には、エンドポイントのアドレスのほかに、アドレスのすべてのプロパティが含まれます。使用例と詳細については、「エンドポイント アドレスの指定」を参照してください。
複数の IIS バインディングのサポート
インターネット サービス プロバイダは、多くの場合、サイトの密度を高めて総所有コストを抑えるため、同じサーバーまたはサイト上で複数のアプリケーションをホストしています。通常、これらのアプリケーションは、異なるベース アドレスにバインドされています。インターネット インフォメーション サービス (IIS) Web サイトは、複数のアプリケーションを格納できます。サイト内のアプリケーションに、1 つ以上の IIS バインディングからアクセスできます。
IIS バインディングは、バインディング プロトコルとバインディング情報という 2 つの情報を提供します。バインディング プロトコルは通信を行うスキームを定義するもので、バインディング情報はサイトにアクセスするために使用する情報です。
IIS バインディングに使用されるコンポーネントの例を次に示します。
- バインディング プロトコル : HTTP
- バインディング情報 : IP アドレス、ポート、ホスト ヘッダー
IIS ではサイトごとに複数の IIS バインディングを指定でき、これによりスキームごとに複数のベース アドレスをサポートできます。.NET Framework 3.5 以前は、WCF ではスキームごとに複数のアドレスがサポートされておらず、複数のアドレスが指定された場合は、アクティブ化の間に ArgumentException がスローされました。
.NET Framework 3.5 により、インターネット サービス プロバイダは同じサイト上の同じスキームに対して別のベース アドレスを使用して複数のアプリケーションをホストできます。
たとえば、サイトで次のベース アドレスを使用できます。
.NET Framework 3.5 では、構成ファイルの AppDomain レベルでプレフィックス フィルタを指定できます。これには、プレフィックスの一覧を格納する <baseAddressPrefixFilters> 要素を使用します。IIS によって指定される受信ベース アドレスは、オプションのプレフィックス一覧に基づいてフィルタ処理されます。既定では、プレフィックスを指定しない場合、すべてのアドレスが渡されます。プレフィックスを指定すると、そのスキームに一致するベース アドレスだけが渡されます。
プレフィックス フィルタを使用する構成コード例を次に示します。
<system.serviceModel>
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
<add prefix="net.tcp://payroll.myorg.com:8000"/>
<add prefix="http://shipping.myorg.com:8000"/>
</baseAddressPrefixFilters>
</serviceHostingEnvironment>
</system.serviceModel>
上記の例では、net.tcp://payroll.myorg.com:8000 と http://shipping.myorg.com:9000 が、対応するスキームに対して渡されるベース アドレスです。
baseAddressPrefixFilter では、ワイルカードはサポートされません。
IIS が提供するベース アドレスには、baseAddressPrefixFilters 一覧に存在しない他のスキームにバインドされたアドレスが指定される場合があります。これらのアドレスはフィルタで除外されません。
WSF サービスによるアドレスの拡張
WCF サービスの既定のアドレス指定モデルでは、エンドポイント アドレス URI を次の目的で使用します。
- サービスがリッスンするアドレス、つまりエンドポイントがメッセージをリッスンする位置の指定
- SOAP アドレス フィルタ、つまりエンドポイントが SOAP ヘッダーとして待機するアドレスの指定
これらの目的で使用する値は個別に指定することができるため、アドレス指定の拡張が可能になり、次に示すような役に立つシナリオに対応します。
- SOAP 中継局 : クライアントが送信したメッセージは、最終目的地に到達する前にメッセージを処理する 1 つ以上の追加サービスを経由します。SOAP 中継局は、メッセージのキャッシュ、ルーティング、負荷分散、スキーム検証など多様なタスクを実行できます。このシナリオは、最終的な送信先である論理アドレス (wsa:To) ではなく、中継局を目的とする独立した物理アドレス (via) にメッセージを送信することによって実現されます。
- エンドポイントがリッスンするアドレスはプライベート URI であり、listenURI プロパティとは異なる値が設定されます。
via が指定するトランスポート アドレスはメッセージが最初に送信される場所で、この後にメッセージは、to パラメータによって指定された、サービスが存在する別のリモート アドレスに送信されます。インターネットの場合、via URI は、サービスの最終的な to アドレスの Uri プロパティと同じになります。この 2 つのアドレスを区別するのは、手動ルーティングを行う必要がある場合のみです。
ヘッダーのアドレス指定
エンドポイントは、基本となる URI だけでなく、1 つ以上の SOAP ヘッダーによってアドレス指定することもできます。これが役に立つのは、エンドポイントのクライアントに中継局を指す SOAP ヘッダーを含める必要がある、SOAP 中継局のシナリオの場合です。
カスタムのアドレス ヘッダーは、コードまたは構成のいずれかを使用して次のように定義できます。
- コードを使用する場合、カスタムのアドレス ヘッダーは AddressHeader クラスを使用して作成し、EndpointAddress の構築時に使用されます。
- 構成を使用する場合、カスタムの <headers> は、<endpoint> 要素の子要素として指定します。
配置後もヘッダーを変更できるため、コードよりも構成を使用する方法を一般的にお勧めします。
カスタム リッスン アドレス
リッスンするアドレスには、エンドポイントの URI とは異なる値を設定できます。これは、SOAP アドレスがパブリックな SOAP 中継局として公開される一方、エンドポイントが実際にリッスンするアドレスはプライベートなネットワーク アドレスであるような中継局シナリオの場合に便利です。
カスタム リッスン アドレスは、コードまたは構成のいずれかを使用して指定できます。
- コードを使用する場合、カスタム リッスン アドレスはエンドポイントの動作コレクションに ClientViaBehavior クラスを追加して指定します。
- 構成を使用する場合、カスタム リッスン アドレスはサービスの <endpoint> 要素の ListenUri 属性で指定します。
カスタム SOAP アドレス フィルタ
エンドポイントの SOAP アドレス フィルタ (AddressFilter) を定義するには、Uri に任意の Headers プロパティを組み合わせて使用します。既定では、このフィルタは受信メッセージの To メッセージ ヘッダーが、エンドポイントの URI に一致し、必要なすべてのエンドポイント ヘッダーがメッセージ内に存在していることを検証します。
シナリオによっては、適切な To ヘッダーを持つメッセージだけではなく、基になるトランスポートに到着したすべてのメッセージをエンドポイントで受信します。これを行うには、ユーザーは MatchAllMessageFilter クラスを使用します。