次の方法で共有

WCF-BasicHttp アダプター

Microsoft BizTalk Server では、WCF-BasicHttp アダプターを使用して、 BasicHttpBinding クラスを介して WCF サービス要求を受信および送信します。 WCF-BasicHttp アダプターを使用すると、オーケストレーションとスキーマを WCF サービスとして発行したり、 BasicHttpBinding を使用して外部 WCF サービスを使用したりできます。

WCF-BasicHttp アダプターを使用すると、従来の ASMX ベースの Web サービスおよび WS-I Basic Profile 1.1 に準拠するクライアントとのコンピューター間通信を、テキスト エンコードで HTTP または HTTPS トランスポートを使用して行うことができます。 ただし、WS-* プロトコルでサポートされている機能を利用することはできません。

次の表は、WCF-BasicHttp アダプターの特性をまとめたものです。

説明 特徴
相互運用性レベル 基本プロファイル
メッセージ エンコード テキストまたは MTOM
限界値 コンピューター間
トランスポート プロトコル HTTP または HTTPS
[セキュリティ モード] None、Message、Transport、TransportWithMessageCredential、TransportCredentialOnly
クライアント認証メカニズム トランスポート セキュリティとメッセージ セキュリティ
WS-ReliableMessaging のサポート いいえ
WS-AtomicTransaction のサポート いいえ
一方向メッセージングのサポート イエス
双方向メッセージングのサポート イエス
受信アダプターのホストの種類 孤立
送信アダプターのホストの種類 処理中

WCF-BasicHttp アダプターは、受信アダプターと送信アダプターの 2 つのアダプターで構成されます。

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

開始する前に

  • BizTalk Server 2016 以降、この送信アダプターは Access Control Service (ACS) または Shared Access Signature (SAS) を使用して Service Bus での認証を行うことができます。 Service Bus で認証する場合は、Shared Access Signature (SAS) を使用することをお勧めします。

    Service Bus 名前空間を作成すると、アクセス制御 (ACS) 名前空間は自動的には作成されません。 ACS を使用して認証する場合は、新しい ACS 名前空間の作成が必要になる場合があります。 ACS キー値を取得する手順など、詳細については、 SB-Messaging アダプター を参照してください。

  • 次のシナリオでは、WCF-BasicHttp アダプターが SOAP アダプターよりも優先されます。

    • WCF アダプターのドキュメントの 1 秒あたりのレートは、一般に SOAP アダプターよりも優れています。
    • SOAP アダプターには、.NET 型と生 XML データの間でメッセージをシリアル化および逆シリアル化する欠点があります。場合によっては、望ましくないデータの変更につながる可能性があります。 WCF アダプターは、データ ストリームを保持するアプローチを採用しています。
    • WCF アダプターは、基本的に BizTalk ランタイムで使用されるスキーマと同じスキーマを発行します。 一方、SOAP アダプターは、スキーマを表すために生成された .NET クラスに反映することによって生成されたメタデータを返します。 .NET では XSD スキーマのすべての微妙な差異が保持されないので、公開されている WSDL は BizTalk ランタイムで使用されるスキーマを正確に反映していない可能性があります。
    • 必要に応じて、WCF-BasicHttp から WCF-WSHttp に移行する方が簡単です。

  • WCF-BasicHttp 受信アダプターを使用して、HTTP または HTTPS プロトコルを介して WCF サービス要求を受信します。 WCF-BasicHttp 送信アダプターを使用して、HTTP または HTTPS プロトコルを使用して、型指定なしのコントラクトを介して WCF サービスを呼び出します。

受信場所を作成する

この受信場所は、一方向または要求応答 (双方向) として構成できます。

注

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

また、プログラムで受信場所を作成することもできます。

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

  2. BizTalk 管理コンソールの左側のウィンドウで、[ 受信ポート ] ノードをクリックします。 次に、右側のウィンドウで、既存の受信場所に関連付けられている受信ポート、または新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。

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

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

  5. WCF-BasicHttp トランスポートのプロパティで、[全般] タブで、WCF-BasicHttp 受信場所のエンドポイント アドレスとサービス ID を構成します。

    注

    セキュリティ モードに Transport またはTransportWithMessageCredential を使用する場合は、Microsoft インターネット インフォメーション サービス (IIS) で Secure Sockets Layer (SSL) を設定する必要があります。

    これを使用する 目的
    アドレス (URI) 必須。 この受信場所の URI を指定します。 BizTalk WCF サービス発行ウィザードで生成される仮想ディレクトリと .svc ファイル名 (/path/service.svc など) を指定します。

    既定値：/

    最小長: 1

    最大長: 255
    エンドポイント ID 任意。 [編集] ボタンをクリックして、この受信場所が提供するサービスの ID を指定します。 エンドポイント ID プロパティに指定できる値は、セキュリティ構成によって異なります。 これらの設定により、クライアントはこの受信場所を認証できます。 クライアントとサービス間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、想定されるサービスの ID がこの要素の値と一致することが保証されます。

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

    最小長: 0

    最大長: 32767

  6. [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ バインド ] タブで、タイムアウトとエンコードのプロパティを構成します。

    これを使用する 目的
    オープン タイムアウト (hh:mmss) チャネルオープン操作が完了するまでに指定された時間間隔を示す期間値を指定します。 この値は System.TimeSpan.Zero 以上である必要があります。

    既定値: 00:01:00

    最大値: 23:59:59
    送信タイムアウト (hh:mmss) 送信操作が完了するまでの時間間隔を示す期間値を指定します。 この値は System.TimeSpan.Zero 以上である必要があります。 要求応答受信ポートを使用する場合、クライアントが大きなメッセージを返した場合でも、この値は対話全体が完了するまでの期間を指定します。

    既定値: 00:01:00

    最大値: 23:59:59
    タイムアウトを閉じる (hh:mmss) チャネルクローズ操作が完了するまでに指定された時間間隔を示す期間値を指定します。 この値は System.TimeSpan.Zero 以上である必要があります。

    既定値: 00:01:00

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

    WCF-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding クラスを 利用してエンドポイントと通信します。 バッファー転送モードの場合、 BasicHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。

    既定値: 65536

    最大値: 2147483647
    メッセージ のエンコード SOAP メッセージのエンコードに使用するエンコーダーを指定します。 有効な値は次のとおりです。

    - テキスト: テキスト メッセージ エンコーダーを使用します。
    - Mtom: Message Transmission Organization Mechanism 1.0 (MTOM) エンコーダーを使用します。

    既定値は Text です。
    テキスト エンコード Message エンコード プロパティが Text に設定されている場合に、バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。 有効な値は次のとおりです。

    - utf-16BE (unicodeFFFE): Unicode BigEndian エンコード。
    - utf-16: 16 ビット エンコード。
    - utf-8: 8 ビット エンコード

    既定値は utf-8 です。
    最大同時呼び出し数 1 つのサービス インスタンスに対する同時呼び出しの数を指定します。 制限を超える呼び出しはキューに登録されます。 この値を 0 に設定することは、 Int32.MaxValue に設定することと同じです。

    既定値は 200 です

  7. [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ セキュリティ ] タブで、セキュリティ機能を定義します。

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

    - なし: 転送中にメッセージはセキュリティで保護されません。
    - トランスポート: セキュリティは HTTPS トランスポートを使用して提供されます。 SOAP メッセージは HTTPS を使用してセキュリティで保護されます。 このモードを使用するには、Microsoft インターネット インフォメーション サービス (IIS) で Secure Sockets Layer (SSL) を設定する必要があります。
    - メッセージ: セキュリティは、HTTP トランスポート上の SOAP メッセージ セキュリティを使用して提供されます。 既定では、SOAP 本文 は暗号化され、署名されます。 WCF-Basic アダプターの有効な メッセージ クライアント資格情報の種類 は Certificate のみです。 このモードには HTTP トランスポートが必要です。 このセキュリティ モードを使用する場合は、この受信場所のサービス証明書を サービス証明書 - 拇印 プロパティを使用して提供する必要があります。
    - TransportWithMessageCredential: 整合性、機密性、およびサービス認証は、HTTPS トランスポートによって提供されます。 このモードを使用するには、Microsoft インターネット インフォメーション サービス (IIS) で Secure Sockets Layer (SSL) を設定する必要があります。
    - TransportCredentialOnly: このモードでは、メッセージの整合性と機密性は提供されません。 HTTP ベースのクライアント認証を提供します。 このモードは注意して使用する必要があります。 トランスポート セキュリティが他の方法 (IPSec など) によって提供され、クライアント認証のみが WCF インフラストラクチャによって提供される環境で使用する必要があります。 このセキュリティ モードで [トランスポート クライアント資格情報の種類] プロパティに [証明書] を選択した場合は、この受信場所のサービス証明書をサービス証明書 - 拇印プロパティを使用して指定する必要があります。

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

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

    既定値は [なし] です。
    メッセージ クライアント資格情報の種類 メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用する資格情報の種類を指定します。 有効な値は次のとおりです。

    - UserName: この受信場所で、 UserName 資格情報を使用してクライアントの認証を要求できるようにします。 クライアント資格情報に対応するドメインまたはローカル ユーザー アカウントを作成する必要があります。
    - 証明書: クライアントは、クライアント証明書を使用して、この受信場所に対して認証されます。 クライアント X.509 証明書の CA 証明書チェーンは、この受信場所に対してクライアントを認証できるように、このコンピューターの信頼されたルート証明機関の証明書ストアにインストールする必要があります。

    既定値は UserName です。
    アルゴリズム スイート メッセージ暗号化アルゴリズムとキー ラップ アルゴリズムを指定します。 これらのアルゴリズムは、セキュリティ ポリシー言語 (WS-SecurityPolicy) 仕様で指定されているものにマップされます。 使用可能な値は次のとおりです。

    - Basic128: Aes128 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa-oaep-mgf1p を使用します。
    - Basic128Rsa15: メッセージ暗号化には Aes128、メッセージ ダイジェストには Sha1、キー ラップには Rsa15 を使用します。
    - Basic128Sha256: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - Basic128Sha256Rsa15: メッセージ暗号化には Aes128、メッセージ ダイジェストには Sha256、キー ラップには Rsa15 を使用します。
    - Basic192: Aes192 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa-oaep-mgf1p を使用します。
    - Basic192Rsa15: メッセージ暗号化には Aes192、メッセージ ダイジェストには Sha1、キー ラップには Rsa15 を使用します。
    - Basic192Sha256: メッセージ暗号化には Aes192、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - Basic192Sha256Rsa15: メッセージ暗号化には Aes192、メッセージ ダイジェストには Sha256、キー ラップには Rsa15 を使用します。
    - Basic256: Aes256 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa-oaep-mgf1p を使用します。
    - Basic256Rsa15: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha1、キー ラップには Rsa15 を使用します。
    - Basic256Sha256: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - Basic256Sha256Rsa15: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha256、キー ラップには Rsa15 を使用します。
    - TripleDes: TripleDes 暗号化を使用し、Sha1 をメッセージ ダイジェストに使用し、Rsa-oaep-mgf1p をキー ラップに使用します。
    - TripleDesRsa15: TripleDes 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa15 を使用します。
    - TripleDesSha256: メッセージ暗号化には TripleDes、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - TripleDesSha256Rsa15: メッセージ暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。

    既定値は Basic256 です。
    サービス証明書 -拇印 クライアントがサービスの認証に使用するこの受信場所の X.509 証明書の拇印を指定します。 拇印は、[参照] ボタンを使用して現在のユーザーの場所にあるマイ ストア内を移動することで選択できます。 手記： この受信場所をホストする受信ハンドラーのユーザー アカウントの 現在のユーザー の場所にサービス証明書をインストールする必要があります。

    最小長: 0

    最大長: 40

    既定値は空の文字列です。
    シングル サインオンを使用する シングル Sign-On を使用して、SSO チケットを発行するクライアント資格情報を取得します。 このオプションは、次のセクション「WCF-BasicHttp 受信アダプターのエンタープライズ シングル Sign-On のサポート可能性」に記載されているセキュリティ構成に対してのみ有効です。

    既定値はクリアされます。

    WCF-BasicHttp 受信アダプターのエンタープライズ シングル Sign-On のサポート このアダプターは、次の表に示すセキュリティ構成でのみ SSO サーバーから SSO チケットを発行できます。

    セキュリティ モード トランスポート クライアントの資格情報の種類 メッセージ クライアント資格情報の種類
    輸送 基本的な なし
    輸送 ダイジェスト なし
    輸送 Ntlm なし
    輸送 ウィンドウズ なし
    輸送 証明書 なし
    メッセージ なし UserName
    TransportWithMessageCredential なし UserName
    TransportCredentialOnly 基本的な なし
    TransportCredentialOnly ダイジェスト なし
    TransportCredentialOnly Ntlm なし
    TransportCredentialOnly ウィンドウズ なし
    TransportCredentialOnly 証明書 なし

  8. [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ メッセージ ] タブで、SOAP Body 要素のデータの選択を指定します。

    これを使用する 目的
    封筒 -- <全体soap:Envelope> 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文部分を作成します。

    既定値はクリアされます。
    Body -- <soap:Body> 要素の内容 受信メッセージの SOAP Body 要素のコンテンツを使用して、BizTalk メッセージ本文パーツを作成します。 Body 要素に複数の子要素がある場合、最初の要素のみが BizTalk メッセージ本文パーツになります。

    これが既定の設定です。
    パス -- 本文パスによって配置されたコンテンツ [本文パス式] テキスト ボックスの 本文パス式 を使用して、BizTalk メッセージ本文パーツを作成します。 本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。

    既定値はクリアされます。
    本体パス式 BizTalk メッセージ本文パーツの作成に使用する受信メッセージの特定の部分を識別する本文パス式を入力します。 このボディパス式は、受信メッセージの SOAP Body 要素の単一の子要素に対して評価されます。 この本文パス式が複数のノードを返す場合、BizTalk メッセージ本文部分には最初のノードのみが選択されます。 このプロパティは、【本文パスで指定されたコンテンツ】のオプションが選択されている場合に必要です。

    種類: 文字列

    最小長: 0

    最大長: 32767

    既定値は空の文字列です。
    ノード エンコード WCF-BasicHttp 受信アダプターが本文パス式で識別されるノードをデコードするために使用するエンコードの種類を [ 本文パス式 ] テキスト ボックスで指定します。

    このプロパティは、本文パスによって配置されたコンテンツのパスオプションが選択されている場合に必要です。 有効な値は次のとおりです。

    - Base64: Base64 エンコード。
    - 16 進数: 16 進エンコード。
    - 文字列: テキスト エンコード - UTF-8
    - XML: WCF アダプターは、本文パス式 テキストボックスで指定されたパス式に基づいてノードを選択し、そのノードの外側の XML を使用して BizTalk メッセージの本文を作成します。

    既定値は XML です。
    本文 -- BizTalk 応答メッセージの本文 BizTalk メッセージ本文パーツを使用して、送信応答メッセージの SOAP Body 要素のコンテンツを作成します。 このプロパティは、要求/応答の受信場所に対してのみ有効です。

    これが既定の設定です。
    テンプレート -- テンプレートで指定されたコンテンツ XML テキスト ボックスに指定されたテンプレートを使用して、送信メッセージの SOAP Body 要素の内容を作成します。 このプロパティは、要求/応答の受信場所に対してのみ有効です。

    既定値はクリアされます。
    XML 送信メッセージの SOAP Body 要素のコンテンツの XML 形式のテンプレートを入力します。 このプロパティは、 テンプレート -- BizTalk 応答メッセージ本文 オプションが選択されている場合に必要です。 このプロパティは、要求/応答の受信場所に対してのみ有効です。

    種類: 文字列

    最小長: 0

    最大長: 32767

    既定値は <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">です。
    失敗した場合に要求メッセージを中断する 受信パイプラインの障害またはルーティングエラーのために受信処理に失敗した要求メッセージを中断するかどうかを指定します。

    既定値はクリアされます。
    エラーに例外の詳細を含める デバッグを容易にするためにエラーが発生したときに SOAP エラーを返すかどうかを指定します。

    既定値はクリアされます。

送信ポートを作成する

注

送信ポートをプログラムで作成することもできます。

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

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

  3. [WCF-BasicHttp トランスポートのプロパティ] ダイアログ ボックスの [全般] タブで、WCF-BasicHttp 送信ポートのエンドポイント アドレス、サービス ID、および SOAPAction HTTP ヘッダーを構成します。

    注

    Address (URI) プロパティに https スキームを指定する場合は、セキュリティ モード プロパティを Transport または TransportWithMessageCredential に構成する必要があります。 [セキュリティ] タブを使用して、[セキュリティ モード] プロパティを構成できます。

    これを使用する 目的
    アドレス (URI) 必須。 この送信ポートの完全修飾 URI を指定します。 セキュリティ構成に応じて 、https または http スキームを使用します。

    最大長: 255

    既定値: http://localhost/
    エンドポイント ID 任意。 この送信ポートで想定されるサービスの ID を指定します。 これらの設定により、この送信ポートでサービスを認証できます。 クライアントとサービス間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、想定されるサービスの ID がこの要素の値と一致することが保証されます。 Identity プロパティに指定できる値は、セキュリティ構成によって異なります。

    既定値はクリアされます。
    アクション 送信メッセージの SOAPAction HTTP ヘッダー フィールドを指定します。 このプロパティは、パイプラインまたはオーケストレーション内でメッセージ コンテキスト プロパティ WCF.Action を使用して設定することもできます。

    この値は、単一アクション形式とアクション マッピング形式の 2 つの異なる方法で指定できます。 このプロパティを単一のアクション形式 ( http://contoso.com/Svc/Op1 など) に設定した場合、送信メッセージの SOAPAction ヘッダーは常に、このプロパティで指定された値に設定されます。

    アクション マッピング形式でこのプロパティを設定した場合、送信 SOAPAction ヘッダーは BTS.Operation コンテキスト プロパティによって決定されます。 たとえば、このプロパティが次の XML 形式に設定され、BTS.Operation プロパティが Op1 に設定されている場合、WCF 送信アダプターは送信するSOAPActionヘッダーにhttp://contoso.com/Svc/Op1を使用します。

    <BtsActionMapping>
    <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />
    <Operation Name="Op2" Action="http://contoso.com/Svc/Op2"/>
    </BtsActionMapping>

    送信メッセージがオーケストレーション ポートから来る場合、オーケストレーション インスタンスはポートの操作名で BTS.Operation プロパティを動的に設定します。 送信メッセージがコンテンツベースのルーティングでルーティングされる場合、パイプラインコンポーネントで BTS.Operation プロパティを設定できます。

    最小長: 0

    最大長: 32767

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

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

    これを使用する 目的
    オープン タイムアウト (hh:mmss) チャネルオープン操作が完了するまでに指定された時間間隔を示す期間値を指定します。 この値は System.TimeSpan.Zero 以上である必要があります。

    既定値: 00:01:00

    最大値: 23:59:59
    送信タイムアウト (hh:mmss) 送信操作が完了するまでの時間間隔を示す期間値を指定します。 この値は System.TimeSpan.Zero 以上である必要があります。 solicit-response 送信ポートを使用する場合、この値は、サービスから大きなメッセージが返された場合でも、対話全体が完了するまでの期間を指定します。

    既定値: 00:01:00

    最大値: 23:59:59
    タイムアウトを閉じる (hh:mmss) チャネルクローズ操作が完了するまでに指定された時間間隔を示す期間値を指定します。 この値は 、System.TimeSpan.Zero 以上である必要があります。

    既定値: 00:01:00

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

    WCF-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding クラスを 利用してエンドポイントと通信します。 バッファー転送モードの場合、 BasicHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。

    既定値: 65536

    最大値: 2147483647
    メッセージ のエンコード SOAP メッセージのエンコードに使用するエンコーダーを指定します。 有効な値は次のとおりです。

    - テキスト: テキスト メッセージ エンコーダーを使用します。
    - Mtom: Message Transmission Organization Mechanism 1.0 (MTOM) エンコーダーを使用します。

    既定値: テキスト
    テキスト エンコード Message エンコード プロパティが Text に設定されている場合に、バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。 有効な値は次のとおりです。

    - utf-16BE (unicodeFFFE): Unicode BigEndian エンコード。
    - utf-16: 16 ビット エンコード。
    - utf-8: 8 ビット エンコード

    既定値: utf-8

  5. [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ セキュリティ ] タブで、WCF-BasicHttp 送信ポートのセキュリティ機能を定義します。

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

    - なし: 転送中にメッセージはセキュリティで保護されません。
    - トランスポート: セキュリティは HTTPS トランスポートを使用して提供されます。 SOAP メッセージは HTTPS を使用してセキュリティで保護されます。 サービスの X.509 証明書の CA 証明書チェーンは、サービスの証明書を使用して送信ポートに対してサービスを認証できるように、このコンピューターの信頼されたルート証明機関の証明書ストアにインストールする必要があります。
    - メッセージ: セキュリティは SOAP メッセージ セキュリティを使用して提供されます。 既定では、SOAP Body 要素は暗号化され、署名されます。 WCF-BasicHttp 送信アダプターの有効な メッセージ クライアント資格情報の種類 は Certificate のみです。 このモードには HTTP トランスポートが必要です。
    - TransportWithMessageCredential: 整合性、機密性、およびサービス認証は、HTTPS トランスポートによって提供されます。 サービスの X.509 証明書の CA 証明書チェーンは、サービスの証明書を使用して送信ポートに対してサービスを認証できるように、このコンピューターの信頼されたルート証明機関の証明書ストアにインストールする必要があります。 送信ポート認証は、SOAP メッセージ セキュリティによって提供されます。
    - TransportCredentialOnly: このモードでは、メッセージの整合性と機密性は提供されません。 HTTP ベースのクライアント認証を提供します。 このモードは注意して使用する必要があります。 トランスポート セキュリティが他の方法 (IPSec など) によって提供され、クライアント認証のみが WCF インフラストラクチャによって提供される環境で使用する必要があります。

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

    - なし: トランスポート レベルでは認証は行われません。
    - 基本: 基本認証。 基本認証では、ユーザー名とパスワードはネットワーク経由でプレーン テキストで送信されます。 このオプションでは、 クライアント資格情報プロパティを構成する 必要があります。
    - ダイジェスト: ダイジェスト認証。 この認証方法は基本認証とよく似ていますが、パスワードはセキュリティを強化するためのハッシュ値としてネットワーク経由で送信される点が異なります。 ダイジェスト認証は、Windows Server オペレーティング システム認証を実行しているドメイン コントローラーがあるドメインでのみ使用できます。 このオプションでは、 クライアント資格情報プロパティを構成する 必要があります。
    - Ntlm: NTLM 認証。 この送信ポートを実行するユーザー アカウントは、この送信ポートを認証するサービスに使用されます。
    - Windows: Windows 統合認証。 この送信ポートを実行するユーザー アカウントは、この送信ポートを認証するサービスに使用されます。
    - 証明書: クライアント証明書 - 拇印 プロパティで指定されたクライアント証明書を使用したクライアント認証。 この資格情報の種類を使用する場合は、サービス証明書 - 拇印 プロパティを使用してサービス証明書を指定する必要があります。

    既定値は [なし] です。
    メッセージ クライアント資格情報の種類 メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用する資格情報の種類を指定します。 有効な値は次のとおりです。

    - UserName: この送信ポートは、 UserName 資格情報を使用してサービスに対して認証されます。 WCF-BasicHttp 送信アダプターの場合、これはサポートされていません。
    - 証明書: この送信ポートは、 クライアント証明書 - 拇印 プロパティで指定されたクライアント証明書を使用してサービスに対して認証されます。 さらに、この資格情報の種類を使用する場合は、サービス証明書 - 拇印 プロパティを使用してサービス証明書を指定する必要があります。

    既定値は UserName です。
    アルゴリズム スイート メッセージ暗号化アルゴリズムとキー ラップ アルゴリズムを指定します。 これらのアルゴリズムは、セキュリティ ポリシー言語 (WS-SecurityPolicy) 仕様で指定されているものにマップされます。 使用可能な値は次のとおりです。

    - Basic128: Aes128 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa-oaep-mgf1p を使用します。
    - Basic128Rsa15: メッセージ暗号化には Aes128、メッセージ ダイジェストには Sha1、キー ラップには Rsa15 を使用します。
    - Basic128Sha256: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - Basic128Sha256Rsa15: メッセージ暗号化には Aes128、メッセージ ダイジェストには Sha256、キー ラップには Rsa15 を使用します。
    - Basic192: Aes192 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa-oaep-mgf1p を使用します。
    - Basic192Rsa15: メッセージ暗号化には Aes192、メッセージ ダイジェストには Sha1、キー ラップには Rsa15 を使用します。
    - Basic192Sha256: メッセージ暗号化には Aes192、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - Basic192Sha256Rsa15: メッセージ暗号化には Aes192、メッセージ ダイジェストには Sha256、キー ラップには Rsa15 を使用します。
    - Basic256: Aes256 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa-oaep-mgf1p を使用します。
    - Basic256Rsa15: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha1、キー ラップには Rsa15 を使用します。
    - Basic256Sha256: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - Basic256Sha256Rsa15: メッセージ暗号化には Aes256、メッセージ ダイジェストには Sha256、キー ラップには Rsa15 を使用します。
    - TripleDes: TripleDes 暗号化を使用し、Sha1 をメッセージ ダイジェストに使用し、Rsa-oaep-mgf1p をキー ラップに使用します。
    - TripleDesRsa15: TripleDes 暗号化、メッセージ ダイジェストに Sha1、キー ラップに Rsa15 を使用します。
    - TripleDesSha256: メッセージ暗号化には TripleDes、メッセージ ダイジェストには Sha256、キー ラップには Rsa-oaep-mgf1p を使用します。
    - TripleDesSha256Rsa15: メッセージ暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。

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

    最小長: 0

    最大長: 40

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

    最小長: 0

    最大長: 40

    既定値は空の文字列です。
    ユーザー名の資格情報 メッセージを送信するための資格情報を指定します。 プロパティを指定するには、[ 編集 ] ボタンをクリックします。 このオプションは、次のセクション「WCF-BasicHttp 送信アダプターのエンタープライズ シングル Sign-On のサポート」に記載されているセキュリティ構成に対してのみ有効です。

    既定値は [シングル サインオンを使用しない] です。
    Service Bus の接続情報 BizTalk Server 2016 以降の新機能。

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

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

    - Shared Access Signature : アクセス キー名とアクセス キーを入力します。 どちらの値も Azure portal に一覧表示されます。
    - アクセス制御サービス : STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/)、発行者名、発行者キーを入力します。 SB-Messaging アダプターで説明されているように、Windows PowerShell を使用してこれらの値 を取得します。

    WCF-BasicHttp 送信アダプターのエンタープライズ シングル Sign-On のサポート WCF-BasicHttp 送信アダプターは、SSO サーバーから SSO チケットを利用して、次の表に示すセキュリティ構成でのみユーザー資格情報を取得できます。

    セキュリティ モード トランスポート クライアントの資格情報の種類 メッセージ クライアント資格情報の種類
    輸送 基本的な なし
    輸送 ダイジェスト なし
    TransportCredentialOnly 基本的な なし
    TransportCredentialOnly ダイジェスト なし
    メッセージ なし UserName
    TransportWithMessageCredential なし UserName

  6. [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ プロキシ ] タブで、WCF-BasicHttp 送信ポートのプロキシ設定を構成します。

    これを使用する 目的
    ハンドラーの既定のプロキシ設定を使用する この送信ポートで、この送信ポートをホストする送信ハンドラーのプロキシ設定を使用するかどうかを指定します。

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

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

    既定値はクリアされます。
    住所 プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて 、https または http スキームを使用します。 このアドレスの後にコロンとポート番号を付けることができます。 たとえば、http://127.0.0.1:8080 のようにします。

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

    種類: 文字列

    最大長: 256

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

    種類: 文字列

    最小長: 0

    最大長: 256

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

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

    種類: 文字列

    最小長: 0

    最大長: 256

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

  7. [ トランスポートのプロパティのWCF-BasicHttp ] ダイアログ ボックスの [ メッセージ ] タブで、SOAP Body 要素のデータ選択を指定します。

    これを使用する 目的
    Body -- BizTalk 要求メッセージの本文 BizTalk メッセージ本文パーツを使用して、送信メッセージの SOAP 本文 要素のコンテンツを作成します。

    これが既定の設定です。
    テンプレート -- テンプレートで指定されたコンテンツ XML テキスト ボックスに指定されたテンプレートを使用して、送信メッセージの SOAP Body 要素の内容を作成します。

    既定値はクリアされます。
    XML 送信メッセージの SOAP Body 要素のコンテンツの XML 形式のテンプレートを入力します。 このプロパティは、 テンプレート -- BizTalk 応答メッセージ本文 オプションが選択されている場合に必要です。

    種類: 文字列

    最小長: 0

    最大長: 32767

    既定値は <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>です。
    封筒 -- <全体soap:Envelope> 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文部分を作成します。 このプロパティは、要請応答ポートに対してのみ有効です。

    既定値はクリアされます。
    Body -- <soap:Body> 要素の内容 受信メッセージの SOAP Body 要素のコンテンツを使用して、BizTalk メッセージ本文パーツを作成します。 Body 要素に複数の子要素がある場合、最初の要素のみが BizTalk メッセージ本文パーツになります。 このプロパティは、要請応答ポートに対してのみ有効です。

    これが既定の設定です。
    パス -- 本文パスによって配置されたコンテンツ [本文パス式] テキスト ボックスの 本文パス式 を使用して、BizTalk メッセージ本文パーツを作成します。 本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。 このプロパティは、要請応答ポートに対してのみ有効です。

    既定値はクリアされます。
    本体パス式 BizTalk メッセージ本文パーツの作成に使用する受信メッセージの特定の部分を識別する本文パス式を入力します。 このボディパス式は、受信メッセージの SOAP Body ノードの直接の子要素に対して評価されます。 この本文パス式が複数のノードを返す場合、BizTalk メッセージ本文部分には最初のノードのみが選択されます。 このプロパティは、本文パスによって配置されたコンテンツのパスオプションが選択されている場合に必要です。 このプロパティは、要請応答ポートに対してのみ有効です。

    種類: 文字列

    最小長: 0

    最大長: 32767

    既定値は空の文字列です。
    ノード エンコード [ 本文パス式 ] テキスト ボックスで、本文パス式で識別されるノードのデコードに WCF-BasicHttp 送信アダプターが使用するエンコードの種類を指定します。 このプロパティは、本文パスによって配置されたコンテンツのパスオプションが選択されている場合に必要です。 このプロパティは、要請応答ポートに対してのみ有効です。 有効な値は次のとおりです。

    - Base64: Base64 エンコード。
    - 16 進数: 16 進エンコード。
    - 文字列: テキスト エンコード - UTF-8
    - XML: WCF アダプターは、本文パス式 テキストボックスで指定されたパス式に基づいてノードを選択し、そのノードの外側の XML を使用して BizTalk メッセージの本文を作成します。

    既定値は XML です。
    エラー メッセージを伝達する 送信処理に失敗したメッセージをサブスクライブしているアプリケーション (別の受信ポートやオーケストレーション スケジュールなど) にルーティングするには、このチェック ボックスをオンにします。 失敗したメッセージを中断し、否定受信確認 (NACK) を生成するには、このチェック ボックスをオフにします。 このプロパティは、要請応答ポートに対してのみ有効です。

    既定値が選択されています。

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

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

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

  2. WCF-BasicHttp を選択し、送信ハンドラーをダブルクリックします。

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

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

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

    既定値はクリアされます。
    住所 プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて 、https または http スキームを使用します。 このアドレスの後にコロンとポート番号を付けることができます。 たとえば、http://127.0.0.1:8080 のようにします。

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

    種類: 文字列

    最大長: 256

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

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

    種類: 文字列

    最小長: 0

    最大長: 256

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

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

    種類: 文字列

    最小長: 0

    最大長: 256

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

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

    こちらも参照ください

WCF アダプターとは

SB-Messaging アダプター

アダプターの使用