WCF-Custom アダプターと WCF-CustomIsolated アダプターを使用して、3 つの WCF 拡張ポイント (動作拡張、バインド要素拡張、バインド拡張機能) を有効にします。 そのためには、まずグローバル アセンブリ キャッシュ (GAC) に WCF 拡張ポイントを実装するアセンブリをインストールしてから、コンピューター上の machine.config ファイルを変更してから、BizTalk Server 管理コンソールを使用して WCF-Custom または WCF-CustomIsolated アダプターを構成します。
WCF 機能拡張ポイントの詳細については、「 WCF の拡張」を参照してください。
[前提条件]
BizTalk Server Administrators グループのメンバーであるアカウントでサインインします。 BizTalk アプリケーションの展開と管理に必要なアクセス許可 について詳しく説明します。
GAC に WCF 機能拡張ポイントを実装するアセンブリをインストールする
WCF 機能拡張ポイントを実装するアセンブリをローカル コンピューター上のフォルダーにコピーします。
WCF 機能拡張ポイントが使用するアセンブリ (存在する場合) をローカル コンピューター上のフォルダーにコピーします。
Visual Studio コマンド プロンプトを起動します。
次のコマンドを入力します。
gacutil.exe /if "<アセンブリ .dll ファイルへのパス>"
これにより、アセンブリが GAC にインストールされ、同じアセンブリ名を持つ既存のアセンブリが上書きされます。
Visual Studio のコマンド プロンプトで、この手順の手順 1 と 2 でコピーしたすべてのアセンブリに対して手順 4 と 5 を繰り返します。
複数の BizTalk Server ランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターでこの手順の手順 1 から 6 を繰り返します。
注
WCF アダプターの WCF 拡張ポイントを有効にするには、アダプターを実行している BizTalk ホスト インスタンスが実行時に、WCF 拡張ポイントが実装されているアセンブリを読み込むことができるようにする必要があります。
WCF バインド拡張機能の machine.config ファイルを構成する
コマンド プロンプトで、%FrameworkDir%\v4 に移動します。X.XXXXX\CONFIG フォルダーを開き、メモ帳を使用して machine.config ファイルを開きます。
メモ帳で、machine.config ファイルに <system.serverModel>\<extensions> 要素がない場合、 これらの要素を machine.config ファイルの <configuration> 要素内に追加し、WCF バインド拡張機能の <bindingExtensions> 要素を <system.serverModel>\<extensions> 要素内に追加します。 たとえば、カスタム バインド拡張機能 netHttpBinding を有効にするには、machine.config ファイルの <configuration> 要素内に次のコードを追加します。
<system.serviceModel> <extensions> <bindingExtensions> <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" /> </bindingExtensions> </extensions> </system.serviceModel>注
- 登録するアセンブリの情報は、 gacutil /lr<assembly_name> コマンドを使用して確認できます。
- この要素 の bindingExtensions を参照してください。
メモ帳で、machine.config ファイルを保存します。
複数の BizTalk Server ランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターでこの手順の手順 1 から 3 を繰り返します。
注
BizTalk ホスト インスタンスと BizTalk Server 管理コンソールの WCF 拡張ポイントを処理するには、WCF インフラストラクチャのすべてのコンピューターでこれらの手順を繰り返す必要があります。
BizTalk 管理コンソールを使用して WCF バインディング拡張機能を構成する
BizTalk Server 管理を開きます。
注
BizTalk Server 管理コンソールが既に開かれている場合は、BizTalk Server 管理コンソールを再起動します。
WCF-Custom アダプターを使用する場合は、BizTalk Server 管理コンソールで、[プラットフォームの設定] を展開し、[ホスト インスタンス] を展開して、アダプターを実行している BizTalk ホスト インスタンスを再起動します。
WCF-CustomIsolated アダプターを使用する場合は、IIS 管理コンソールで、WCF 受信場所に関連付けられているアプリケーション プールを再起動します。
WCF 機能拡張ポイントを使用するように受信場所を構成する場合は、BizTalk Server 管理コンソールで BizTalk グループを展開し、<BizTalk アプリケーションを展開>、受信場所を展開し、右側のウィンドウで<をダブルクリック>。
- [ 受信場所のプロパティ ] ダイアログ ボックスの [種類 ] ドロップダウン リストで、使用する WCF アダプターに応じて [ WCF-Custom ] または [ WCF-CustomIsolated ] を選択し、[ 構成] をクリックします。
WCF 機能拡張ポイントを使用するように送信ポートを構成する場合は、BizTalk Server 管理コンソールで BizTalk グループを展開し、<BizTalk アプリケーションを展開>、送信ポートを展開し、右側のウィンドウで<送信ポート>をダブルクリックします。
- [ 送信ポートのプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、[ WCF-Custom] を選択し、[ 構成] をクリックします。
[トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブで、バインド拡張機能を選択し、トランスポートの残りの設定を構成します。
BizTalk Server 管理コンソールで、[ OK] ボタンをクリックして開いているすべてのダイアログ ボックスを閉じ、エラー メッセージと誤ったイベント ログが表示されていないことを確認します。
WCF バインド要素拡張機能の machine.config ファイルを構成する
コマンド プロンプトで、%FrameworkDir%\v4 に移動します。X.XXXXX\CONFIG フォルダーを開き、メモ帳を使用して machine.config ファイルを開きます。
メモ帳で、machine.config ファイルに <system.serverModel>\<extensions> 要素がない場合、 これらの要素を machine.config ファイルの <configuration> 要素内に追加し、WCF バインド要素拡張機能の <bindingElementExtensions> 要素を <system.serverModel>\<extensions> 要素内に追加します。 たとえば、カスタム バインド要素拡張機能の droppingInterceptor を有効にするには、machine.config ファイルの <configuration> 要素内に次のコードを追加します。
<system.serviceModel> <extensions> <bindingElementExtensions> <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/> </bindingElementExtensions> </extensions> </system.serviceModel>注
- 登録するアセンブリの情報は、 gacutil /lr<assembly_name> コマンドを使用して確認できます。
- この要素の bindingElementExtensions を参照してください。
メモ帳で、machine.config ファイルを保存します。
複数の BizTalk Server ランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターでこの手順の手順 1 から 3 を繰り返します。
注
BizTalk ホスト インスタンスと BizTalk Server 管理コンソールの WCF 拡張ポイントを処理するには、WCF インフラストラクチャのすべてのコンピューターでこれらの手順を繰り返す必要があります。
BizTalk 管理コンソールを使用して WCF バインド要素拡張機能を構成する
BizTalk Server 管理を開きます。
注
BizTalk Server 管理コンソールが既に開かれている場合は、BizTalk Server 管理コンソールを再起動します。
WCF-Custom アダプターを使用する場合は、BizTalk Server 管理コンソールで、[プラットフォームの設定] を展開し、[ホスト インスタンス] を展開して、アダプターを実行している BizTalk ホスト インスタンスを再起動します。
WCF-CustomIsolated アダプターを使用する場合は、IIS 管理コンソールで、WCF 受信場所に関連付けられているアプリケーション プールを再起動します。
WCF 機能拡張ポイントを使用するように受信場所を構成する場合は、BizTalk Server 管理コンソールで BizTalk グループを展開し、<BizTalk アプリケーションを展開>、受信場所を展開し、右側のウィンドウで<をダブルクリック>。
- [ 受信場所のプロパティ ] ダイアログ ボックスの [種類 ] ドロップダウン リストで、使用する WCF アダプターに応じて [ WCF-Custom ] または [ WCF-CustomIsolated ] を選択し、[ 構成] をクリックします。
WCF 機能拡張ポイントを使用するように送信ポートを構成する場合は、BizTalk Server 管理コンソールで BizTalk グループを展開し、<BizTalk アプリケーションを展開>、送信ポートを展開し、右側のウィンドウで<送信ポート>をダブルクリックします。
- [ 送信ポートのプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、[ WCF-Custom] を選択し、[ 構成] をクリックします。
[トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブの [ バインドの種類 ] ドロップダウン リストで、[ customBinding] を選択します。
[トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブで、[ バインド ] リストのクライアント領域を右クリックし、[ 拡張機能の追加] をクリックします。
[ バインド要素拡張機能の選択 ] ダイアログ ボックスで、バインド要素の拡張機能を選択し、[OK] をクリック します。
[トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブで、前の手順で追加したバインド要素拡張機能の種類に応じて、 バインド リストに追加されたバインド要素の順序を次のように調整します。
[バインド] の一覧で、バインド要素の拡張機能を右クリックし、[拡張機能を上に移動] または [拡張機能を下に移動] をクリックします。 バインド リストの最下位のバインド要素拡張機能は、チャネル スタックの下部コンポーネントに対応します。 バインディング リストの最上位のバインド要素は、通信スタックの最上位コンポーネントに対応します。
注
カスタム バインドのバインド要素の特定の順序についての詳細は、「カスタム バインド」を参照してください。
[トランスポートのプロパティ] ダイアログ ボックスで、トランスポートの残りの設定を構成します。
BizTalk Server 管理コンソールで、[ OK] ボタンをクリックして開いているすべてのダイアログ ボックスを閉じ、エラー メッセージと誤ったイベント ログが表示されていないことを確認します。
WCF 動作拡張機能の machine.config ファイルを構成する
コマンド プロンプトで、%FrameworkDir%\v4 に移動します。X.XXXXX\CONFIG フォルダーを開き、メモ帳を使用して machine.config ファイルを開きます。
メモ帳で、machine.config ファイルに <system.serverModel>\<extensions> 要素がない場合は、 これらの要素を machine.config ファイルの <configuration> 要素内に追加し、WCF 動作拡張機能の <behaviorExtensions> 要素を <system.serverModel>\<extensions> 要素内に追加します。 たとえば、カスタム動作拡張機能 schemaValidator を有効にするには、machine.config ファイルの <configuration> 要素内に次のコードを追加します。
<system.serviceModel> <extensions> <behaviorExtensions> <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/> </behaviorExtensions> </extensions> </system.serviceModel>注
- 登録するアセンブリの情報は、 gacutil /lr<assembly_name> コマンドを使用して確認できます。
- この要素 の behaviorExtensions を参照してください。
メモ帳で、machine.config ファイルを保存します。
複数の BizTalk Server ランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターでこの手順の手順 1 から 3 を繰り返します。
注
BizTalk ホスト インスタンスと BizTalk Server 管理コンソールの WCF 拡張ポイントを処理するには、WCF インフラストラクチャのすべてのコンピューターでこれらの手順を繰り返す必要があります。
BizTalk 管理コンソールを使用して WCF 動作拡張機能を構成する
BizTalk Server 管理を開きます。
注
BizTalk Server 管理コンソールが既に開かれている場合は、BizTalk Server 管理コンソールを再起動します。
WCF-Custom アダプターを使用する場合は、BizTalk Server 管理コンソールで、[プラットフォームの設定] を展開し、[ホスト インスタンス] を展開して、アダプターを実行している BizTalk ホスト インスタンスを再起動します。
WCF-CustomIsolated アダプターを使用する場合は、IIS 管理コンソールで、WCF 受信場所に関連付けられているアプリケーション プールを再起動します。
WCF 機能拡張ポイントを使用するように受信場所を構成する場合は、BizTalk 管理コンソールで BizTalk グループを展開し、<BizTalk アプリケーションを展開>、受信場所を展開し、右側のウィンドウで<をダブルクリック>。
- [ 受信場所のプロパティ ] ダイアログ ボックスの [種類 ] ドロップダウン リストで、使用する WCF アダプターに応じて [ WCF-Custom ] または [ WCF-CustomIsolated ] を選択し、[ 構成] をクリックします。
WCF 拡張ポイントを使用するように送信ポートを構成する場合は、BizTalk 管理コンソールで BizTalk グループを展開し、<BizTalk アプリケーションを展開>、送信ポートを展開し、右側のウィンドウで<ポートの送信>をダブルクリックします。
- [ 送信ポートのプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、[ WCF-Custom] を選択し、[ 構成] をクリックします。
[トランスポートのプロパティ] ダイアログ ボックスの [ 動作 ] タブで、動作拡張機能の種類に応じて [ServiceBehavior ] または [EndpointBehavior ] を右クリックし、[ 動作拡張機能の選択 ] ダイアログ ボックスで動作拡張機能を選択し、[ OK] をクリックします。
[トランスポートのプロパティ] ダイアログ ボックスで、トランスポートの残りの設定を構成します。
BizTalk Server 管理コンソールで、[ OK] ボタンをクリックして開いているすべてのダイアログ ボックスを閉じ、エラー メッセージと誤ったイベント ログが表示されていないことを確認します。
SSL 証明書を使用して WCF-Custom 受信場所を構成する
- WCF-Custom 受信場所が httpsTransport バインディング要素などの HTTP カーネル モード ドライバー (HTTP.sys) を使用する場合、Secure Sockets Layer (SSL) 通信では、受信場所に各ソケット (IP アドレスとポートの組み合わせ) に証明書が登録されている必要があります。 HttpCfg.exe ツールを使用して、SSL 証明書をコンピューター上のポートにバインドします。 詳細については、「 方法: SSL 証明書を使用してポートを構成する」を参照してください。