WCF-BasicHttp アダプタ
Microsoft BizTalk Server では、WCF-BasicHttp アダプターを使用して、BasicHttpBinding クラスを介して WCF サービス要求を受信および送信します。 WCF-BasicHttp アダプターを使用すると、オーケストレーションとスキーマを WCF サービスとして発行したり、 BasicHttpBinding を使用して外部 WCF サービスを使用したりできます。
WCF-BasicHttp アダプターを使用して、WS-I 基本プロファイル 1.1 準拠のレガシ ASMX ベースの Web サービスおよびクライアントとコンピューター間通信を実行できます (テキスト エンコードによる HTTP または HTTPS トランスポートを使用します)。 ただし、WS-* プロトコルによってサポートされる機能を利用することはできません。
次の表は、WCF-BasicHttp アダプターの特性をまとめたものです。
| 説明 | 特徴 |
|---|---|
| 相互運用性レベル | 基本プロファイル |
| [メッセージ エンコード] | テキストまたは MTOM |
| 限界値 | コンピュータ間 |
| トランスポート プロトコル | HTTP または HTTPS |
| [セキュリティ モード] | None、Message、Transport、TransportWithMessageCredential、および TransportCredentialOnly |
| クライアント認証のメカニズム | トランスポート セキュリティとメッセージ セキュリティ |
| WS-ReliableMessaging のサポート | No |
| WS-AtomicTransaction のサポート | No |
| 一方向メッセージングのサポート | はい |
| 双方向メッセージングのサポート | はい |
| 受信アダプタのホストの種類 | Isolated |
| 送信アダプタのホストの種類 | インプロセス |
WCF-BasicHttp アダプターは、受信アダプターと送信アダプターの 2 つのアダプターで構成されます。
このトピックでは、BizTalk 管理を使用して受信場所と送信ポートを作成する方法について説明します。 また、受信場所を作成し、プログラムでポートを送信することもできます。
開始する前に
BizTalk Server 2016 以降では、この送信アダプターは、Access Control サービス (ACS) または Shared Access Signature (SAS) を使用して Service Bus を理解できます。 Service Bus で認証する場合は、Shared Access Signature (SAS) を使用することをお勧めします。
Service Bus 名前空間を作成しても、Access Control (ACS) 名前空間は自動的には作成されません。 ACS を使用して認証する場合は、新しい ACS 名前空間を作成する必要がある場合があります。 ACS キー値を取得する手順など、詳細については SB-Messaging adapter を参照してください。
次のシナリオでは、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 サービスを呼び出すのに使用します。
受信場所を作成する
この受信場所は、一方向または要求応答 (双方向) として構成できます。
BizTalk 管理コンソールで、[BizTalk Server管理]、[BizTalk グループ]、[アプリケーション] の順に展開し、受信場所を作成するアプリケーションを展開します。
BizTalk 管理コンソールの左側のウィンドウで、[ 受信ポート ] ノードをクリックします。 次に右ウィンドウで、既存の受信場所に関連付けられているか、新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。
[ 受信ポートのプロパティ ] ダイアログ ボックスの左ウィンドウで [ 受信場所] を選択します。次に、右ウィンドウで既存の受信場所をダブルクリックするか、または [ 新規作成 ] をクリックして、新しい受信場所を作成します。
[受信場所のプロパティ] ダイアログ ボックスの [種類] の横にある [トランスポート] セクションで、ドロップダウン リストから [WCF-BasicHttp] を選択し、[構成] をクリックします。
[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 を指定します。 Endpoint Identity プロパティに指定できる値は、セキュリティ構成によって異なります。 これらの設定により、クライアントはこの受信場所を認証できます。 クライアントとサービスの間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値と予期されるサービスの ID が照合されます。
既定値は空の文字列です。
最小長: 0
最大長:32767[ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ バインド ] タブで、タイムアウトとエンコードのプロパティを構成します。
プロパティ 目的 [オープン タイムアウト (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-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding クラスを 利用してエンドポイントと通信します。 バッファーされたトランスポート モードの場合、 BasicHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。
既定値:65536
最大値: 2147483647メッセージのエンコード SOAP メッセージをエンコードするために使用されるエンコーダーを指定します。 有効な値は次のとおりです。
- テキスト: テキスト メッセージ エンコーダーを使用します。
- Mtom: メッセージ送信組織メカニズム 1.0 (MTOM) エンコーダーを使用します。
既定値は Text です。テキストのエンコード Message encoding プロパティが Text に設定されている場合に、バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。 有効な値は次のとおりです。
- utf-16BE (unicodeFFFE): Unicode BigEndian エンコード。
- utf-16: 16 ビット エンコード。
- utf-8: 8 ビット エンコード
既定値は utf-8 です。[最大同時呼び出し数] 単一のサービス インスタンスに対する同時呼び出しの数を指定します。 制限を超える呼び出しはキューに格納されます。 この値を 0 に設定することは、 Int32.MaxValue に設定することと同じです。
既定値は 200 です[ 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 インフラストラクチャによってクライアント認証のみが提供される環境で使用する必要があります。 このセキュリティ モードで [トランスポート クライアント資格情報の種類] プロパティに [証明書] を選択した場合は、この受信場所のサービス証明書を [サービス証明書 - 拇印] プロパティで指定する必要があります。
既定値は [None](なし) です。トランスポート クライアントの資格情報の種類 クライアント認証の実行時に使用する資格情報の種類を指定します。 有効な値は次のとおりです。
- なし: トランスポート レベルで認証は行われません。
- 基本: 基本認証。 基本認証では、ユーザー名とパスワードは、ネットワークを経由してプレーン テキストで送信されます。 資格情報に対応するドメイン ユーザー アカウントまたはローカル ユーザー アカウントを作成する必要があります。
- ダイジェスト: ダイジェスト認証。 この認証方法は、動作が基本認証とよく似ています。ただし、セキュリティの強化のために、パスワードは、ネットワーク経由でハッシュ値として送信されます。 ダイジェスト認証は、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 証明書の拇印を指定します。 拇印は、[ 参照 ] ボタンを使用して [ 現在のユーザー ] の場所の [ My ] ストアを参照して選択できます。 メモ： この受信場所をホストしている受信ハンドラーのユーザー アカウントの 現在 のユーザーの場所にサービス証明書をインストールする必要があります。
最小長: 0
最大長:40
既定値は空の文字列です。シングル サインオンの使用 シングル サインオンを使用して、クライアントの資格情報を取得し、SSO チケットを発行します。 このオプションは、次の「WCF-BasicHttp 受信アダプターに対するエンタープライズ シングル サインオンのサポート」に示すセキュリティ構成に対してのみ有効です。
既定値はオフです。WCF-BasicHttp 受信アダプターのエンタープライズ シングル Sign-On サポート このアダプターは、次の表に示すセキュリティ構成でのみ、SSO サーバーから SSO チケットを発行できます。
セキュリティ モード トランスポート クライアントの資格情報の種類 証明書 トランスポート Basic 該当なし トランスポート ダイジェスト 該当なし トランスポート Ntlm 該当なし トランスポート Windows N/A トランスポート [証明書] 該当なし メッセージ 該当なし UserName TransportWithMessageCredential 該当なし UserName TransportCredentialOnly Basic 該当なし TransportCredentialOnly ダイジェスト 該当なし TransportCredentialOnly Ntlm 該当なし TransportCredentialOnly Windows N/A TransportCredentialOnly [証明書] 該当なし [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ メッセージ ] タブで、SOAP Body 要素のデータ選択を指定します。
プロパティ 目的 封筒 -- soap 全体 <:封筒> 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文パーツを作成します。
既定値はオフです。Body -- soap:Body> 要素の<内容 受信メッセージの SOAP Body 要素の内容を使用して、BizTalk メッセージ本文パーツを作成します。 Body 要素に複数の子要素がある場合、最初の要素のみが BizTalk メッセージ本文パーツになります。
これが既定の設定です。[パス -- 本文のパスで見つかったコンテンツ] [本文パス式] テキスト ボックスの本文 パス式 を使用して、BizTalk メッセージ本文パーツを作成します。 本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。
既定値はオフです。本文のパス式 BizTalk メッセージのボディ部を作成するために使用する受信メッセージの特定の部分を示すボディ パス式を入力します。 この本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。 このボディ パス式で複数のノードが返される場合は、最初のノードのみが BizTalk メッセージのボディ部に対して選択されます。 [ パス- 本文パスで配置されたコンテンツ ] オプションが選択されている場合は、このプロパティが必要です。
型: String
最小長: 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 応答メッセージ本文 オプションが選択されている場合に必要です。 このプロパティは、要求 - 応答の受信場所に対してのみ有効です。
型: String
最小長: 0
最大長:32767
既定値は、<bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">です。[エラー発生時に要求メッセージを保留する] 受信パイプラインまたはルーティングの障害によって受信処理に失敗した要求メッセージを保留するかどうかを指定します。
既定値はオフです。[エラーに例外の詳細を含める] エラーが発生した場合に、デバッグのために SOAP エラーを返すかどうかを指定します。
既定値はオフです。
送信ポートを作成する
注意
また、プログラムで送信ポートを作成することもできます。
BizTalk 管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。 詳細については、「 送信ポートを作成する方法」を参照してください。 すべての送信ポート オプションを構成し、[全般] タブの [トランスポート] セクションの [種類] オプションに WCF-BasicHttp を指定します。
[ 全般 ] タブの [ トランスポート ] セクションで、[種類] の横にある [構成 ] ボタンをクリック します。
[ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ 全般 ] タブで、WCF-BasicHttp 送信ポートのエンドポイント アドレス、サービス ID、 および SOAPAction HTTP ヘッダーを構成します。
注意
Address (URI) プロパティに https スキームを指定する場合は、Security mode プロパティを Transport またはTransportWithMessageCredential に構成する必要があります。 [ セキュリティ ] タブを使用して、[ セキュリティ モード ] プロパティを構成できます。
プロパティ 目的 アドレス (URI) 必須。 この送信ポートの完全修飾 URI を指定します。 セキュリティ構成に応じて、 https または http スキームを使用します。
最大長: 255
既定値:http://localhost/[エンドポイント ID] 任意。 この送信ポートが必要とするサービスの ID を指定します。 これらの設定により、この送信ポートでサービスを認証できます。 クライアントとサービスの間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値と予期されるサービスの ID が照合されます。 Identity プロパティに指定できる値は、セキュリティ構成によって異なります。
既定値はオフです。操作 送信メッセージの SOAPAction HTTP ヘッダー フィールドを指定します。 このプロパティは、メッセージ コンテキスト プロパティ WCF を使用して設定することもできます 。 パイプラインまたはオーケストレーションでのアクション。
この値は、単一アクション形式とアクション マッピング形式の 2 つの異なる方法で指定できます。 このプロパティを 1 つのアクション形式 (例: ) で設定した場合、http://contoso.com/Svc/Op1送信メッセージの SOAPAction ヘッダーは常に、このプロパティで指定された値に設定されます。
このプロパティをアクション マッピング形式で設定した場合、送信 SOAPAction ヘッダーは BTS によって決定されます 。操作 コンテキスト プロパティ。 たとえば、このプロパティが次の 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
既定値は空の文字列です。[WCF-BasicHttp トランスポート プロパティ] の [バインド] タブで、タイムアウトプロパティとエンコード プロパティを構成します。
プロパティ 目的 [オープン タイムアウト (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-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding クラスを 利用してエンドポイントと通信します。 バッファー転送モードの場合、 BasicHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。
既定値:65536
最大値: 2147483647メッセージ エンコード SOAP メッセージをエンコードするために使用されるエンコーダーを指定します。 有効な値は次のとおりです。
- テキスト: テキスト メッセージ エンコーダーを使用します。
- Mtom: Message Transmission Organization Mechanism 1.0 (MTOM) エンコーダーを使用します。
既定値: Textテキストのエンコード Message encoding プロパティが Text に設定されている場合に、バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。 有効な値は次のとおりです。
- utf-16BE (unicodeFFFE): Unicode BigEndian エンコード。
- utf-16: 16 ビット エンコード。
- utf-8: 8 ビット エンコード
既定値: utf-8[ 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 インフラストラクチャによってクライアント認証のみが提供される環境で使用する必要があります。
既定値は [None](なし) です。トランスポート クライアントの資格情報の種類 送信ポート認証の実行時に使用する資格情報の種類を指定します。 有効な値は次のとおりです。
- なし: トランスポート レベルでは認証は行われません。
- 基本: 基本認証。 基本認証では、ユーザー名とパスワードは、ネットワークを経由してプレーン テキストで送信されます。 このオプションでは、 クライアント資格情報 プロパティを構成する必要があります。
- ダイジェスト: ダイジェスト認証。 この認証方法は、動作が基本認証とよく似ています。ただし、セキュリティの強化のために、パスワードは、ネットワーク経由でハッシュ値として送信されます。 ダイジェスト認証は、Windows Server オペレーティング システムの認証を実行しているドメイン コントローラーを使用するドメインでのみ使用できます。 このオプションでは、 クライアント資格情報 プロパティを構成する必要があります。
- Ntlm: NTLM 認証。 この送信ポートを実行するユーザー アカウントは、サービスがこの送信ポートを認証するために使用されます。
- Windows: Windows 統合認証。 この送信ポートを実行するユーザー アカウントは、サービスがこの送信ポートを認証するために使用されます。
- 証明書: クライアント証明書 - 拇印 プロパティで指定されたクライアント証明書を使用したクライアント認証。 この資格情報の種類を使用する場合は、サービス証明書 - 拇印 プロパティを使用してサービス証明書を指定する必要があります。
既定値は [None](なし) です。証明書 メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用する、資格情報の種類を指定します。 有効な値は次のとおりです。
- 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 証明書の拇印を指定します。 [参照] ボタンを使用して、ローカル コンピューターの場所にある [その他のPeople ストア] に移動する拇印を選択できます。
最小長: 0
最大長:40
既定値は空の文字列です。[ユーザー名の資格情報] メッセージを送信するための資格情報を指定します。 プロパティを指定するには、[ 編集 ] ボタンをクリックします。 このオプションは、次の「WCF-BasicHttp 送信アダプターに対するエンタープライズ シングル サインオンのサポート」に示すセキュリティ構成に対してのみ有効です。
既定値は [シングル サインオンを使用しない] です。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を使用します。WCF-BasicHttp 送信アダプターのエンタープライズ シングル Sign-On サポート WCF-BasicHttp 送信アダプターは、SSO サーバーから SSO チケットを引き換えて、次の表に示すセキュリティ構成でのみユーザー資格情報を取得できます。
セキュリティ モード トランスポート クライアントの資格情報の種類 証明書 トランスポート Basic 該当なし トランスポート ダイジェスト 該当なし TransportCredentialOnly Basic 該当なし TransportCredentialOnly ダイジェスト 該当なし メッセージ 該当なし UserName TransportWithMessageCredential 該当なし UserName [ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ プロキシ ] タブで、WCF-BasicHttp 送信ポートのプロキシ設定を構成します。
プロパティ 目的 [ハンドラーの既定のプロキシ構成を使用する] この送信ポートがホストされている送信ハンドラーのプロキシ設定を使用するかどうかを指定します。
これが既定の設定です。[プロキシを使用しない] この送信ポートがプロキシ サーバーを使用するかどうかを示します。
既定値はオフです。[プロキシを使用する] この送信ポートが Address プロパティで指定されたプロキシ サーバーを使用するかどうかを示します。
既定値はオフです。アドレス プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて、 https または http スキームを使用します。 このアドレスの後に、コロンとポート番号を指定します。 たとえば、「 http://127.0.0.1:8080 」のように入力します。
このプロパティには、 プロキシの使用 が選択されている場合にのみ値が必要です。
型: String
最大長: 256
既定値は空の文字列です。ユーザー名 認証に使用するユーザー名を指定します。 統合認証が使用されている場合、ユーザー名にはドメインが含まれ、"ドメイン\ユーザー名" となります。 基本認証またはダイジェスト認証が使用されている場合、ユーザー名には "ドメイン\" を含めません。 このプロパティには、 プロキシの使用 が選択されている場合にのみ値が必要です。 メモ： WCF-BasicHttp 送信アダプターは、プロキシの基本認証を使用します。
型: String
最小長: 0
最大長: 256
既定値は空の文字列です。パスワード 認証に使用するパスワードを指定します。
このプロパティには、 プロキシの使用 が選択されている場合にのみ値が必要です。
型: String
最小長: 0
最大長: 256
既定値は空の文字列です。[ WCF-BasicHttp トランスポートのプロパティ ] ダイアログ ボックスの [ メッセージ ] タブで、SOAP Body 要素のデータ選択を指定します。
プロパティ 目的 本文 -- BizTalk 要求メッセージ本文 BizTalk メッセージ本文パーツを使用して、送信メッセージの SOAP Body 要素のコンテンツを作成します。
これが既定の設定です。[テンプレート -- テンプレートで指定されたコンテンツ] XML テキスト ボックスに用意されているテンプレートを使用して、送信メッセージの SOAP Body 要素の内容を作成します。
既定値はオフです。XML 送信メッセージの SOAP Body 要素のコンテンツの XML 形式のテンプレートを入力します。 このプロパティは、 テンプレート -- BizTalk 応答メッセージ本文 オプションが選択されている場合に必要です。
型: String
最小長: 0
最大長:32767
既定値は、<bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>です。封筒 -- soap 全体 <:封筒> 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文パーツを作成します。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。
既定値はオフです。Body -- soap:Body> 要素の<内容 受信メッセージの SOAP Body 要素の内容を使用して、BizTalk メッセージ本文パーツを作成します。 Body 要素に複数の子要素がある場合、最初の要素のみが BizTalk メッセージ本文パーツになります。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。
これが既定の設定です。[パス -- 本文のパスで見つかったコンテンツ] [本文パス式] テキスト ボックスの本文 パス式 を使用して、BizTalk メッセージ本文パーツを作成します。 本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。
既定値はオフです。本文のパス式 BizTalk メッセージのボディ部を作成するために使用する受信メッセージの特定の部分を示すボディ パス式を入力します。 この本文パス式は、受信メッセージの SOAP 本文 ノードの直接の子要素に対して評価されます。 このボディ パス式で複数のノードが返される場合は、最初のノードのみが BizTalk メッセージのボディ部に対して選択されます。 [ パス- 本文パスで配置されたコンテンツ ] オプションが選択されている場合は、このプロパティが必要です。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。
型: String
最小長: 0
最大長:32767
既定値は空の文字列です。[ノード エンコード] [ 本文パス式 ] テキスト ボックスで、本文パス式で識別されるノードのデコードに WCF-BasicHttp 送信アダプターが使用するエンコードの種類を指定します。 [ パス- 本文パスで配置されたコンテンツ ] オプションが選択されている場合は、このプロパティが必要です。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。 有効な値は次のとおりです。
- Base64: Base64 エンコード。
- 16 進数: 16 進エンコード。
- 文字列: テキスト エンコード - UTF-8
- XML: WCF アダプターは、本文パス式テキスト ボックスの本文パス式で選択されたノードの外部 XML を使用して BizTalk メッセージ 本文 を作成します。
既定値は XML です。障害メッセージの伝達 送信処理に失敗したメッセージを、他の受信ポートやオーケストレーション スケジュールなど、そのメッセージをサブスクライブしているアプリケーションに回送する場合は、このチェック ボックスをオンにします。 失敗したメッセージを保留し、否定の確認 (NACK) を生成する場合は、このチェック ボックスをオフにします。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。
既定値が選択されています。
送信ハンドラーにプロキシを追加する
送信ポートまたは送信ハンドラーにプロキシを追加できます。 送信ポートでプロキシを追加する場合は、このセクションをスキップします。
BizTalk Server管理コンソールで、[BizTalk Server管理] を展開し、[BizTalk グループ]、[プラットフォームの設定] の順に展開して、[アダプター] を展開します。
[ WCF-BasicHttp] を選択し、送信ハンドラーをダブルクリックします。
[ アダプター ハンドラーのプロパティ] の [ 全般 ] タブで、[プロパティ] を選択 します。
[ プロキシ ] タブで、次の操作を行います。
プロパティ 目的 [プロキシを使用する] この送信ハンドラーがプロキシ サーバーを使用するかどうかを示します。
既定値はオフです。アドレス プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて、 https または http スキームを使用します。 このアドレスの後に、コロンとポート番号を指定します。 たとえば、「 http://127.0.0.1:8080 」のように入力します。
このプロパティには、 プロキシの使用 が選択されている場合にのみ値が必要です。
型: String
最大長: 256
既定値は空の文字列です。ユーザー名 認証に使用するユーザー名を指定します。 統合認証または基本認証が使用されている場合は、"ドメイン\ユーザー名" のように、ユーザー名にドメインを含めます。 ダイジェスト認証が使用されている場合は、ユーザー名に "ドメイン\" を含めません。
このプロパティには、 プロキシの使用 が選択されている場合にのみ値が必要です。
型: String
最小長: 0
最大長: 256
既定値は空の文字列です。パスワード 認証に使用するパスワードを指定します。
このプロパティには、 プロキシの使用 が選択されている場合にのみ値が必要です。
型: String
最小長: 0
最大長: 256
既定値は空の文字列です。すべてのダイアログ ボックスを終了するまで [ OK] をクリックします 。
こちらもご覧ください