次の方法で共有

WCF-WebHttp アダプター

  • [アーティクル]

Microsoft BizTalk Server では、WCF-WebHttp アダプターを使用して、RESTful サービスにメッセージを送信します。 WCF-WebHttp 送信アダプターは、BizTalk メッセージからサービスに HTTP メッセージを送信します。 受信場所は RESTful サービスからのメッセージを受信します。 GET および DELETE 要求の場合、アダプターはペイロードを使用しません。 POST および PUT 要求の場合は、アダプターは HTTP コンテンツ/ペイロードに BizTalk メッセージのボディ部を使用します。

このトピックでは、BizTalk 管理を使用して受信場所と送信ポートを作成する方法について説明します。

受信場所を作成する

Note

次の手順を完了する前に、一方向の受信ポートを既に追加しておく必要があります。 「受信ポートを作成する方法」を参照してください。

  1. BizTalk Server管理コンソールで、[BizTalk Server管理] を展開し、[BizTalk グループ]、[アプリケーション] の順に展開し、受信場所を作成するアプリケーションを展開します。

  2. 左側のウィンドウで、[ 受信ポート ] ノードをクリックし、右側のウィンドウで、新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。

  3. [ 受信ポートのプロパティ ] ダイアログ ボックスの左側のウィンドウで [ 受信場所] を選択し、右側のウィンドウで [ 新規作成 ] をクリックして、新しい受信場所を作成します。

  4. [ 受信場所のプロパティ ] ダイアログ ボックスの [ トランスポート ] セクションで、[ 種類 ] ドロップダウン リストから [ WCF-WebHttp ] を選択します。次に、[ 構成 ] をクリックして、受信場所のトランスポートのプロパティを構成します。

  5. [ 全般 ] タブで、メッセージの受信元の REST インターフェイスのエンドポイント アドレスを構成します。

    プロパティ 目的
    アドレス (URI) 必須。 BIZTALK SERVERが HTTP ベースの RESTful メッセージを受信できる URI を指定します。
    [エンドポイント ID] 省略可能。 エンドポイント ID を指定します。 これらの設定により、エンドポイントはこの受信場所を認証できます。 エンドポイントと受信場所のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値と予期されるサービスの ID が照合されます。

    既定値は空の文字列です。
    [HTTP メソッドと URL マッピング] BTS 操作マッピングによって、ユーザーは、受信 HTTP メソッドと URL サブパスに基づいて、メッセージ コンテキスト内で受信 HTTP 要求を BTS 操作にマップすることができます。 受信 HTTP メソッドと URL サブパスは、一連の HTTP メソッドと URI テンプレートと照合されます。 一致項目が見つかると、アダプターは、メッセージ内で指定された値を使って、 BTS.Operation プロパティを BizTalk メッセージ コンテキストに昇格させます。

    HTTP メソッドは、単一形式として、またはマルチマッピング形式として、URL マッピングに指定できます。 マルチマッピング形式は、以下のようになります。

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345</BtsHttpUrlMapping>

    前のスニペットでは、顧客 ID は定数値 ( 12345) として指定されています。 ただし、顧客 ID またはその他のクエリ変数を、実行時に決定しなければならないシナリオもあります。 このようなシナリオを実現するには、URL の変数コンポーネントを中かっこ { } で囲んで指定する必要があります。 たとえば、前のスニペットでは、顧客 ID を変数として指定する場合は、次のようになります。

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}</BtsHttpUrlMapping>

    このような場合、実行時に変数 ID の値をどこから選択するかも指定する必要があります。 これは、[ 変数マッピング] を使用して指定します。

    注
    URL フィールド内では、任意の特殊な XML 文字を "エスケープ" する必要があります。 これにより、特殊な XML 文字が確実に処理され、ポートによって保持されます。 たとえば、特殊文字は & として &amp;エスケープする必要があります。

    差出人:
    Url=”/Customer?{ID}& group=Location”
    移動先:
    Url=”/Customer?{ID}&amp;group=Location”
    変数マッピング [HTTP メソッドと URL マッピング] で変数を指定した場合は、実行時に変数がマッピングされる対象を指定する必要があります。 [ 編集 ] をクリックして、[ 変数マッピング ] ダイアログ ボックスを表示します。 ダイアログ ボックスの [ 変数 ] 列に、[ HTTP メソッドと URL マッピング] で定義した変数の一覧が表示されます。 [ プロパティ名 ] フィールドで、変数に関連付けられる値を提供するプロパティの名前を指定する必要があります。 ソリューションの一部として、このプロパティを事前に定義/昇格しておく必要があります。 また、[ プロパティ名前空間 ] フィールドで、プロパティの名前空間も指定する必要があります。

  6. [ バインド ] タブで、タイムアウトとエンコード関連のプロパティを構成します。

    プロパティ 目的
    [オープン タイムアウト (hh:mm:ss)] チャネルを開く操作が完了するまでの間隔を示す期間値を指定します。 System.TimeSpan.Zero以上の値を指定してください。

    既定値:00:01:00

    最大値: 23:59:59
    [送信タイムアウト (hh:mm:ss)] 送信操作が完了するまでの間隔を示す期間値を指定します。 System.TimeSpan.Zero以上の値を指定してください。 要求 - 応答受信ポートを使用する場合、この値は、対話処理がすべて完了するまでの時間を指定します。これは、クライアントが大きなメッセージを返した場合にも適用されます。

    既定値:00:01:00

    最大値: 23:59:59
    [クローズ タイムアウト (hh:mm:ss)] チャネルを閉じる操作が完了するまでの間隔を示す期間値を指定します。 System.TimeSpan.Zero以上の値を指定してください。

    既定値:00:01:00

    最大値: 23:59:59
    [最大受信メッセージ サイズ (バイト単位)] 有線ネットワーク上で受信できる、ヘッダーを含むメッセージの最大サイズをバイト単位で指定します。 メッセージのサイズは、各メッセージに割り当てられているメモリの量に制限されます。 このプロパティを使用して、サービス拒否 (DoS) 攻撃にさらされる危険性を制限できます。

    WCF-WebHttp アダプターでは、バッファリングされた送信モードで WebHttpBinding クラスを活用して、エンドポイントと通信します。 バッファリングされたトランスポート モードでは、 WebHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。

    既定値:65536

    最大値: 2147483647
    [最大同時呼び出し数] 単一のサービス インスタンスに対する同時呼び出しの数を指定します。 制限を超える呼び出しはキューに格納されます。 この値を 0 に設定することは、 Int32.MaxValue に設定することと同じです。

    既定では 200 です。

  7. [ セキュリティ ] タブで、受信場所 WCF-WebHttp のセキュリティ機能を定義します。

    プロパティ 目的
    セキュリティ モード 使用するセキュリティの種類を指定します。 有効な値は次のとおりです。

    - なし: 転送中にメッセージはセキュリティで保護されません。

    - トランスポート: セキュリティは HTTPS トランスポートを使用して提供されます。 SOAP メッセージは、HTTPS を使用してセキュリティ保護されます。 このモードを使用するには、Microsoft インターネット インフォメーション サービス (IIS) の Secure Sockets Layer (SSL) を設定する必要があります。

    - TransportWithMessageCredential: 整合性、機密性、およびサービス認証は、HTTPS トランスポートによって提供されます。 このモードを使用するには、Microsoft インターネット インフォメーション サービス (IIS) の Secure Sockets Layer (SSL) を設定する必要があります。

    既定値は [ トランスポート] です。
    トランスポート クライアントの資格情報の種類 クライアント認証の実行時に使用する資格情報の種類を指定します。 有効な値は次のとおりです。

    - なし: トランスポート レベルで認証は行われません。

    - 基本: 基本認証。 基本認証では、ユーザー名とパスワードは、ネットワークを経由してプレーン テキストで送信されます。 資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。

    - ダイジェスト: ダイジェスト認証。 この認証方法は、動作が基本認証とよく似ています。ただし、セキュリティの強化のために、パスワードは、ネットワーク経由でハッシュ値として送信されます。 ダイジェスト認証は、Windows Server オペレーティング システムの認証を実行しているドメイン コントローラーを使用するドメインでのみ使用できます。 クライアントの資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。

    - Ntlm: NTLM 認証。 クライアントは、この受信場所にパスワードを送信せずに資格情報を送信できます。 クライアントの資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。

    - Windows: Windows 統合認証。 Windows Communication Foundation は、Kerberos または NTLM をネゴシエートします。ドメインが存在する場合には、Kerberos の方とネゴシエートします。 Kerberos を使用する場合は、クライアントがサービス プリンシパル名 (SPN) によってサービスを識別できるようにすることが重要です。 クライアントの資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。

    - 証明書: クライアント証明書を使用したクライアント認証。 クライアントをこの受信場所に対して認証できるように、クライアントの X.509 証明書の CA 証明書チェーンを、このコンピューターの信頼されたルート証明機関の証明書ストアにインストールする必要があります。

    メモトランスポート クライアント資格情報の種類プロパティは、この受信場所をホストしている IIS 仮想ディレクトリの認証スキームと一致する必要があります。 たとえば、このプロパティが [ Windows] に設定されている場合は、これをホストする仮想ディレクトリの [ 統合 Windows 認証 ] も有効にする必要があります。 同様に、このプロパティが [ なし] に設定されている場合は、この受信場所をホストする仮想ディレクトリへの匿名アクセスを許可する必要があります。

    既定値は Windows です。
    [サービス証明書の拇印] クライアントがサービスの認証に使用する、この受信場所に対する X.509 証明書の拇印を指定します。 拇印は、[ 参照 ] ボタンを使用して [ 現在のユーザー ] の場所の [ My ] ストアを参照して選択できます。

    メモ この受信場所をホストしている受信ハンドラーのユーザー アカウントの 現在 のユーザーの場所にサービス証明書をインストールする必要があります。

    最小長: 0

    最大長:40

    既定値は空の文字列です。

  8. [ 動作 ] タブで、サービス レベルとエンドポイント レベルで異なる動作を指定します。 これらの動作は、.NET Frameworkクラスに基づいています。

    プロパティ 目的
    ServiceBehavior WCF サービスの機能をサービス レベルで拡張します。 セキュリティ設定の定義、デバッグの有効化、調整の実装、その他の .NET クラスの使用など、さまざまな操作を行う拡張機能を追加できます。

    [ServiceBehavior] を右クリックし、[拡張機能の追加] を選択します。 この一覧には、使用できる .NET クラスが表示されます。
    EndpointBehavior エンドポイント レベルで要求を受信する方法の機能を拡張します。 ブラウザー ベースの ASP.NET AJAX クライアントからの HTTP 要求の受信、トランザクションの時間間隔の指定、メッセージの同期または非同期の受信の選択、その他の .NET クラスの使用など、さまざまな処理を行う拡張機能を追加できます。

    [EndpointBehavior] を右クリックし、[拡張機能の追加] を選択します。 この一覧には、使用できる .NET クラスが表示されます。

    これは、WCF-Custom 受信場所の動作構成に似ています。 UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-Custom トランスポート プロパティ] ダイアログ ボックスの [受信]、[動作] タブを参照してください。

  9. [ メッセージ ] タブで、SOAP Body 要素のデータ選択を指定します。

    プロパティ 目的
    送信 HTTP ヘッダー 応答メッセージがある場合はそれに設定される HTTP ヘッダーを指定します。
    [エラー発生時に場所を無効にする] 受信パイプラインまたはルーティングの障害によって受信処理に失敗した受信場所を無効にするかどうかを指定します。

    既定値はオフです。
    [エラー発生時に要求メッセージを保留する] 受信パイプラインまたはルーティングの障害によって受信処理に失敗した要求メッセージを保留するかどうかを指定します。

    既定値はオフです。
    [エラーに例外の詳細を含める] エラーが発生した場合に、デバッグのために SOAP エラーを返すかどうかを指定します。

    既定値はオフです。

  10. [OK] をクリックします。

  11. [ 受信場所のプロパティ ] ダイアログ ボックスで、受信場所を構成するための適切な値を入力し、[ OK ] をクリックして設定を保存します。 [ 受信場所のプロパティ ] ダイアログ ボックスの詳細については、「 受信場所を作成する方法」を参照してください。

送信ポートを作成する

  1. BizTalk 管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。 「 送信ポートを作成する方法」を参照してください。 すべての送信ポート オプションを構成し、[全般] タブの [トランスポート] セクションの [種類] オプションに WCF-WebHttp を指定します。

  2. [ 全般 ] タブの [ トランスポート ] セクションで、[ 構成 ] ボタンをクリックします。

  3. [ 全般 ] タブで、メッセージが送信される REST インターフェイスのエンドポイント アドレスを構成します。

    プロパティ 目的
    アドレス (URI) 必須。 メッセージが送信された REST インターフェイスの URI を指定します。
    [エンドポイント ID] 省略可能。 エンドポイント ID を指定します。 これらの設定により、エンドポイントはこの送信ポートを認証できます。 エンドポイントと受信場所のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値と予期されるサービスの ID が照合されます。

    既定値は空の文字列です。
    [HTTP メソッドと URL マッピング] BTS 操作マッピングによって、ユーザーは、受信 HTTP メソッドと URL サブパスに基づいて、メッセージ コンテキスト内で受信 HTTP 要求を BTS 操作にマップすることができます。 受信 HTTP メソッドと URL サブパスは、一連の HTTP メソッドと URI テンプレートと照合されます。 一致項目が見つかると、アダプターは、メッセージ内で指定された値を使って、 BTS.Operation プロパティを BizTalk メッセージ コンテキストに昇格させます。

    HTTP メソッドは、単一形式として、またはマルチマッピング形式として、URL マッピングに指定できます。 マルチマッピング形式は、以下のようになります。

    BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345" /> </BtsHttpUrlMapping>

    前のスニペットでは、顧客 ID は定数値 ( 12345) として指定されています。 ただし、顧客 ID またはその他のクエリ変数を、実行時に決定しなければならないシナリオもあります。 このようなシナリオを実現するには、URL の変数コンポーネントを中かっこ { } で囲んで指定する必要があります。 たとえば、前のスニペットでは、顧客 ID を変数として指定する場合は、次のようになります。

    <BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}" /> </BtsHttpUrlMapping>

    このような場合、実行時に変数 ID の値をどこから選択するかも指定する必要があります。 これは、[ 変数マッピング] を使用して指定します。

    注
    URL フィールド内では、特殊な XML 文字を "エスケープ" する必要があります。 これにより、特殊な XML 文字が確実に処理され、ポートによって保持されます。 たとえば、特殊文字は & として &amp;エスケープする必要があります。

    差出人:
    Url=”/Customer?{ID}& group=Location”
    移動先:
    Url=”/Customer?{ID}&amp;group=Location”
    変数マッピング [HTTP メソッドと URL マッピング] で変数を指定した場合は、実行時に変数がマッピングされる対象を指定する必要があります。 [ 編集 ] をクリックして、[ 変数マッピング ] ダイアログ ボックスを表示します。 ダイアログ ボックスの [ 変数 ] 列に、[ HTTP メソッドと URL マッピング] で定義した変数の一覧が表示されます。 [ プロパティ名 ] フィールドで、変数に関連付けられる値を提供するプロパティの名前を指定する必要があります。 ソリューションの一部として、このプロパティを事前に定義/昇格しておく必要があります。 また、[ プロパティ名前空間 ] フィールドで、プロパティの名前空間も指定する必要があります。

  4. [ バインド ] タブで、タイムアウトとエンコード関連のプロパティを構成します。

    プロパティ 目的
    [オープン タイムアウト (hh:mm:ss)] チャネルを開く操作が完了するまでの間隔を示す期間値を指定します。 System.TimeSpan.Zero以上の値を指定してください。

    既定値:00:01:00

    最大値: 23:59:59
    [送信タイムアウト (hh:mm:ss)] 送信操作が完了するまでの間隔を示す期間値を指定します。 System.TimeSpan.Zero以上の値を指定してください。 要求 - 応答受信ポートを使用する場合、この値は、対話処理がすべて完了するまでの時間を指定します。これは、クライアントが大きなメッセージを返した場合にも適用されます。

    既定値:00:01:00

    最大値: 23:59:59
    [クローズ タイムアウト (hh:mm:ss)] チャネルを閉じる操作が完了するまでの間隔を示す期間値を指定します。 System.TimeSpan.Zero以上の値を指定してください。

    既定値:00:01:00

    最大値: 23:59:59
    [最大受信メッセージ サイズ (バイト単位)] 有線ネットワーク上で受信できる、ヘッダーを含むメッセージの最大サイズをバイト単位で指定します。 メッセージのサイズは、各メッセージに割り当てられているメモリの量に制限されます。 このプロパティを使用して、サービス拒否 (DoS) 攻撃にさらされる危険性を制限できます。

    WCF-WebHttp アダプターでは、バッファリングされた送信モードで WebHttpBinding クラスを活用して、エンドポイントと通信します。 バッファリングされたトランスポート モードでは、 WebHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。

    既定値:65536

    最大値: 2147483647

  5. [ セキュリティ ] タブで、WCF-WebHttp 送信ポートのセキュリティ機能を定義します。

    プロパティ 目的
    セキュリティ モード 使用するセキュリティの種類を指定します。 有効な値は次のとおりです。

    - なし: 転送中にメッセージはセキュリティで保護されません。
    - トランスポート: セキュリティは HTTPS トランスポートを使用して提供されます。 SOAP メッセージは、HTTPS を使用してセキュリティ保護されます。 サービスの証明書を使用してサービスを送信ポートに対して認証できるように、サービスの X.509 証明書の CA 証明書チェーンを、このコンピューターの信頼されたルート証明機関の証明書ストアにインストールする必要があります。
    - TransportWithMessageCredential: 整合性、機密性、およびサービス認証は、HTTPS トランスポートによって提供されます。 サービスの X.509 証明書の CA 証明書チェーンは、サービスの証明書を使用して送信ポートに対してサービスを認証できるように、このコンピューターの信頼されたルート証明機関証明書ストアにインストールする必要があります。 送信ポートの認証は、SOAP メッセージのセキュリティによって提供されます。

    既定値は [None](なし) です。
    トランスポート クライアントの資格情報の種類 クライアント認証の実行時に使用する資格情報の種類を指定します。 有効な値は次のとおりです。

    - なし: トランスポート レベルでは認証は行われません。
    - 基本: 基本認証。 基本認証では、ユーザー名とパスワードは、ネットワークを経由してプレーン テキストで送信されます。 資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。
    - ダイジェスト: ダイジェスト認証。 この認証方法は、動作が基本認証とよく似ています。ただし、セキュリティの強化のために、パスワードは、ネットワーク経由でハッシュ値として送信されます。 ダイジェスト認証は、Windows Server オペレーティング システムの認証を実行しているドメイン コントローラーを使用するドメインでのみ使用できます。 クライアントの資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。
    - Ntlm: NTLM 認証。 クライアントは、この受信場所にパスワードを送信せずに資格情報を送信できます。 クライアントの資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。
    - Windows: Windows 統合認証。 Windows Communication Foundation は、Kerberos または NTLM をネゴシエートします。ドメインが存在する場合には、Kerberos の方とネゴシエートします。 Kerberos を使用する場合は、クライアントがサービス プリンシパル名 (SPN) によってサービスを識別できるようにすることが重要です。 クライアントの資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。
    - 証明書: クライアント証明書を使用したクライアント認証。 クライアントをこの受信場所に対して認証できるように、クライアントの X.509 証明書の CA 証明書チェーンを、このコンピューターの信頼されたルート証明機関の証明書ストアにインストールする必要があります。 メモ：トランスポート クライアント資格情報の種類プロパティは、この受信場所をホストしている IIS 仮想ディレクトリの認証スキームと一致する必要があります。 たとえば、このプロパティが [ Windows] に設定されている場合は、これをホストする仮想ディレクトリの [ 統合 Windows 認証 ] も有効にする必要があります。 同様に、このプロパティが [ なし] に設定されている場合は、この受信場所をホストする仮想ディレクトリへの匿名アクセスを許可する必要があります。

    既定値は Windows です。
    クライアント証明書 - 拇印 この送信ポートをエンドポイントに対して認証する際に使用する X.509 証明書の拇印を指定します。 拇印を選択するには、[参照] ボタンを使用して [現在のユーザー] の場所にある [マイ ストア] に移動します。 メモ： この送信ポートをホストする送信ハンドラーのユーザー アカウントの 現在 のユーザーの場所にクライアント証明書をインストールする必要があります。

    最小長: 0

    最大長:40

    既定値は空の文字列です。
    [サービス証明書の拇印] この送信ポートのメッセージ送信先のエンドポイントを認証する際に使用する X.509 証明書の拇印を指定します。 [参照] ボタンを使用して、ローカル コンピューターの場所にある [その他のPeople ストア] に移動する拇印を選択できます。

    最小長: 0

    最大長:40

    既定値は空の文字列です。
    [ユーザー名の資格情報] メッセージを送信するための資格情報を指定します。 プロパティを指定するには、[ 編集 ] ボタンをクリックします。 [メッセージ クライアントの資格情報の種類] で [ユーザー名] オプションを選択した場合は、資格情報を設定する必要があります。

    既定値は [シングル サインオンを使用しない] です。
    [ACS サービス ID を使用する] BizTalk Server 2013 R2 および BizTalk Server 2013 に適用されます。

    このチェック ボックスをオンにし、[ 編集 ] をクリックし、Service Bus で認証するために次の値を指定します。 これは、Service Bus 関連エンティティの REST インターフェイスを呼び出す場合にのみ必要です。

    - Access Control Service STS Uri – これを にhttps://<Namespace>-sb.accesscontrol.windows.net/設定します。ここで、<名前空間>は Service Bus 名前空間です。
    - 発行者名 – 発行者 名を指定します。 通常は所有者に設定します。
    - 発行者キー – 発行者 キーを指定します。
    Service Bus 接続情報 BizTalk Server 2016 以降の新機能。

    Service Bus 名前空間の Shared Access Signature (SAS) または Access Control Service (ACS) を使用することを選択します。

    オプションを選択し、[ 編集 ] を選択してキー情報を入力します。

    - Shared Access Signature : アクセス キー名とアクセス キーを入力します。 両方の値がAzure portalに一覧表示されます。
    - Access Control サービス: STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/)、発行者名、発行者キーを入力します。 SB メッセージング アダプターの説明に従って、これらの値を取得するには、Windows PowerShellを使用します。

  6. [ 動作 ] タブで、この送信ポートのエンドポイントの動作を構成します。

    プロパティ 目的
    EndpointBehavior エンドポイント レベルで要求を送信する方法の機能を拡張します。 SOAP 処理動作の定義、トランザクションの時間間隔の指定、検出機能の制御、その他の .NET クラスの使用など、さまざまな処理を行う拡張機能を追加できます。

    [EndpointBehavior] を右選択し、[拡張機能の追加] を選択します。 この一覧には、使用できる .NET クラスが表示されます。

    これは、WCF-Custom 送信ポートのエンドポイント動作の構成と似ています。 UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-Custom トランスポートプロパティ]ダイアログ ボックスの[送信]、[動作]タブ」を参照してください。

  7. [ プロキシ ] タブで、WCF-WebHttp 送信ポートのプロキシ設定を構成します。

    プロパティ 目的
    [送信ハンドラーのプロキシ設定を使用する] この送信ポートがホストされている送信ハンドラーのプロキシ設定を使用するかどうかを指定します。

    これが既定の設定です。
    [プロキシを使用しない] この送信ポートがプロキシ サーバーを使用するかどうかを示します。

    既定値はオフです。
    [プロキシを使用する] この送信ポートが Address プロパティで指定されたプロキシ サーバーを使用するかどうかを示します。

    既定値はオフです。
    アドレス プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて、 https または http スキームを使用します。 このアドレスの後に、コロンとポート番号を指定します。 たとえば、「 http://127.0.0.1:8080 」のように入力します。

    このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。

    型: String

    最大長: 256

    既定値は空の文字列です。
    ユーザー名 認証に使用するユーザー名を指定します。 統合認証が使用されている場合、ユーザー名にはドメインが含まれ、"ドメイン\ユーザー名" となります。 基本認証またはダイジェスト認証が使用されている場合、ユーザー名には "ドメイン\" を含めません。 このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。 メモ： WCF-WebHttp 送信アダプターは、プロキシの基本認証を使用します。

    型: String

    最小長: 0

    最大長: 256

    既定値は空の文字列です。
    パスワード 認証に使用するパスワードを指定します。

    このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。

    型: String

    最小長: 0

    最大長: 256

    既定値は空の文字列です。

  8. [ メッセージ ] タブで、メッセージを REST インターフェイスに送信する方法を指定します。

    プロパティ 目的
    送信 HTTP ヘッダー 応答メッセージがある場合はそれに設定される HTTP ヘッダーを指定します。
    動詞の本文を抑制 REST エンドポイントを呼び出すために使用する動詞に応じて、メッセージ ペイロードが必要な場合と不要な場合があります。 たとえば、GET または DELETE 動詞を使用するときには、メッセージ ペイロードは必要ではない可能性があります。 ただし、送信ポートを使用して REST エンドポイントの呼び出しをトリガーするには、メッセージ ペイロードを含むダミー メッセージを使用できます。 メッセージが REST エンドポイントに送信される前に、ダミー メッセージからメッセージ ペイロードを削除する必要があります。 メッセージ ペイロードを削除する必要がある動詞は、 Verbs の本文の抑制 プロパティを使用して指定できます。

    たとえば、GET 動詞の使用中にメッセージ ペイロードを削除する場合は、このプロパティの値を として GET指定します。

  9. [ OK] を クリックし、もう一度 [OK] を クリックして設定を保存します。

WCF 拡張機能をインポートする

受信ハンドラーまたは送信ハンドラーに WCF 拡張機能をインポートします。

  1. [BizTalk Server管理] で、[BizTalk Server管理] を展開し、[BizTalk グループ]、[プラットフォームの設定] の順に展開し、[アダプター] を展開します。

  2. [ WCF-WebHttp] を選択し、受信ハンドラーまたは送信ハンドラーをダブルクリックします。

  3. [全般] タブで、[ プロパティ] を選択します。

  4. [WCF 拡張機能] で [インポート] を選択し、WCF 拡張機能の構成ファイルを参照します。

送信ハンドラーにプロキシを追加する

送信ポートまたは送信ハンドラーにプロキシを追加できます。 送信ポートでプロキシを追加する場合は、このセクションをスキップします。

  1. BizTalk Server管理コンソールで、[BizTalk Server管理] を展開し、[BizTalk グループ]、[プラットフォーム設定] の順に展開し、[アダプター] を展開します。

  2. [ WCF-WebHttp] を選択し、送信ハンドラーを選択します。

  3. [ アダプター ハンドラーのプロパティ] の [ 全般 ] タブで、[プロパティ] を選択 します。

  4. [ プロキシ ] タブで、次の操作を行います。

    プロパティ 目的
    [プロキシを使用する] この送信ハンドラーがプロキシ サーバーを使用するかどうかを示します。

    既定値はオフです。
    アドレス プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて、 https または http スキームを使用します。 このアドレスの後に、コロンとポート番号を指定します。 たとえば、「 http://127.0.0.1:8080 」のように入力します。

    このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。

    型: String

    最大長: 256

    既定値は空の文字列です。
    ユーザー名 認証に使用するユーザー名を指定します。 統合認証または基本認証が使用されている場合は、"ドメイン\ユーザー名" のように、ユーザー名にドメインを含めます。 ダイジェスト認証が使用されている場合は、ユーザー名に "ドメイン\" を含めません。

    このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。

    型: String

    最小長: 0

    最大長: 256

    既定値は空の文字列です。
    パスワード 認証に使用するパスワードを指定します。

    このプロパティには、[ プロキシを使用する ] が選択されている場合にのみ値が必要です。

    型: String

    最小長: 0

    最大長: 256

    既定値は空の文字列です。

  5. すべてのダイアログ ボックスを終了するまで [ OK] をクリックします 。

参照

SB-Messaging アダプター

アダプターの使用

WCF アダプターについて