WCF-BasicHttpRelay アダプター

  • [アーティクル]

Microsoft BizTalk Server では、WCF-BasicHttpRelay アダプターを使用して、BasicHttpRelayBinding クラスを介して WCF サービス要求を受信および送信します。 WCF-BasicHttpRelay アダプターは、BasicHttpRelayBinding を使用して Service Bus リレー エンドポイントを使用します。

開始する前に

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 を参照してください。

受信場所を作成する

Note

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

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

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

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

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

  5. [ WCF-BasicHttpRelay トランスポートのプロパティ ] ダイアログ ボックスの [ 全般 ] タブで、Service Bus リレー エンドポイントがホストされているエンドポイント アドレスと、WCF-BasicHttpRelay 受信場所のサービス ID を構成します。

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

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

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

    プロパティ 目的
    [オープン タイムアウト (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-BasicHttpRelay アダプターは、バッファー転送モードの BasicHttpRelayBinding クラスを 利用してエンドポイントと通信します。 バッファートランスポート モードの場合、 BasicHttpRelayBinding.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 です。
    [最大同時呼び出し数] 単一のサービス インスタンスに対する同時呼び出しの数を指定します。 制限を超える呼び出しはキューに格納されます。 この値を 0 に設定することは、 Int32.MaxValue に設定することと同じです。

    既定では 200 です。

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

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

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

    既定値は [ トランスポート] です。
    証明書 上記のセキュリティ モードを Message または TransportWithMessageCredential に設定した場合にのみ、メッセージ レベルのセキュリティ オプションを指定します。 有効な値は次のとおりです。

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

    既定値は UserName です。
    [アルゴリズム スイート] 上記のセキュリティ モードを Message または TransportWithMessageCredential に設定した場合にのみ、メッセージ暗号化アルゴリズムとキー ラップ アルゴリズムを指定します。 セキュリティ モードを [なし] または [トランスポート] に設定した場合、これは適用されません。

    これらのアルゴリズムは、セキュリティ ポリシー言語 (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 ] ストアを参照して選択できます。 メモ： このプロパティは、上記の セキュリティ モード モード を Message または TransportWithMessageCredential に設定した場合にのみ設定する必要があります。 セキュリティ モードを [なし] または [トランスポート] に設定した場合、これは適用されません。 メモ： この受信場所をホストしている受信ハンドラーのユーザー アカウントの 現在 のユーザーの場所にサービス証明書をインストールする必要があります。

    最小長: 0

    最大長:40

    既定値は空の文字列です。
    [リレー クライアントの認証の種類] メッセージの送信元となる Service Bus リレー エンドポイントでの認証のオプションを指定します。 有効な値は次のとおりです。

    - なし: 認証は必要ありません。
    - RelayAccessToken: Service Bus Relay エンドポイントで承認するためにセキュリティ トークンを使用するには、これを指定します。

    既定値は [ RelayAccessToken] です。
    [サービス検出の有効化] サービスの動作をサービス レジストリに発行するには、このチェック ボックスをオンにします。

    - 表示名 – サービスがサービス レジストリに発行される名前を指定します。
    - 探索モード – サービス レジストリで公開されているサービスの探索モードを設定します。 詳細については、「 DiscoveryType Enum」を参照してください。
    [アクセス制御サービス] BizTalk Server 2013 R2 および BizTalk Server 2013 に適用されます。

    [ リレー クライアントの認証の種類 ] を [ RelayAccessToken] に設定した場合は、[ 編集 ] ボタンをクリックして、以下の詳細を指定してください。

    - 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を使用してこれらの値を取得します。

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

    プロパティ 目的
    封筒 -- soap 全体 <:封筒> 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文パーツを作成します。

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

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

    既定値はオフです。
    本文のパス式 BizTalk メッセージのボディ部を作成するために使用する受信メッセージの特定の部分を示すボディ パス式を入力します。 この本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。 このボディ パス式で複数のノードが返される場合は、最初のノードのみが BizTalk メッセージのボディ部に対して選択されます。 [ パス- 本文パスで配置されたコンテンツ ] オプションが選択されている場合は、このプロパティが必要です。

    型: String

    最小長: 0

    最大長:32767

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

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

    - 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 エラーを返すかどうかを指定します。

    既定値はオフです。

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

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

送信ポートを作成する

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

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

  3. [ WCF-BasicHttpRelay トランスポートのプロパティ ] ダイアログ ボックスの [ 全般 ] タブで、次を指定します。

    プロパティ 目的
    アドレス (URI) 必須。 Service Bus にリレー エンドポイントをデプロイする URL を指定します。 通常、URL は次のような形式になっています。

    https://<namespace>.servicebus.windows.net/
    [エンドポイント ID] 省略可能。 エンドポイント ID を指定します。 これらの設定により、この送信ポートでエンドポイントを認証できるようになります。 エンドポイントと送信ポートの間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値とエンドポイントの ID が照合されます。

    既定値はオフです。
    操作 送信メッセージの SOAPAction HTTP ヘッダー フィールドを指定します。 このプロパティは、メッセージ コンテキスト プロパティ WCF を使用して設定することもできます 。 パイプラインまたはオーケストレーションのアクション。 この値は、単一アクション形式とアクション マッピング形式の 2 つの異なる方法で指定できます。 このプロパティを単一のアクション形式 (たとえば、 ) で設定した場合、 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 プロパティ。

    重要:

    Service Bus では、メッセージをリレー エンドポイントに送信するときに SOAP アクションを設定する必要があります。

    最小長: 0

    最大長:32767

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

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

    プロパティ 目的
    [オープン タイムアウト (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-BasicHttpRelay アダプターは、バッファー転送モードの 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

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

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

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

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

    - メッセージ: セキュリティは SOAP メッセージ セキュリティを使用して提供されます。 既定では、SOAP Body 要素は暗号化され、署名されます。 WCF-BasicHttpRelay 送信アダプターの有効な メッセージ クライアント資格情報の種類 は Certificate のみです。 このモードには、HTTP トランスポートが必要です。

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

    既定値は [None](なし) です。
    証明書 上記のセキュリティ モードを Message または TransportWithMessageCredential に設定した場合にのみ、メッセージ レベルのセキュリティ オプションを指定します。 有効な値は次のとおりです。

    - UserName: この送信ポートは、 UserName 資格情報を使用してエンドポイントに対して認証されます。 WCF-BasicHttpRelay 送信アダプターは、これをサポートしていません。

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

    既定値は 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

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

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

    このチェック ボックスをオンにし、[ 編集 ] をクリックし、Service Bus で認証するために次の値を指定します。

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

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

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

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

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

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

    型: String

    最大長: 256

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

    メモ:

    WCF-BasicHttpRelay 送信アダプターでは、プロキシに対して基本認証を使用します。

    型: String

    最小長: 0

    最大長: 256

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

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

    型: String

    最小長: 0

    最大長: 256

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

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

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

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

    既定値はオフです。
    XML 送信メッセージの SOAP ody 要素のコンテンツの 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-BasicHttpRelay 送信アダプターが使用するエンコードの種類を指定します。 [ パス- 本文パスで配置されたコンテンツ ] オプションが選択されている場合は、このプロパティが必要です。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。 有効な値は次のとおりです。

    - Base64: Base64 エンコード。

    - 16 進数: 16 進エンコード。

    - 文字列: テキスト エンコード - UTF-8

    - XML: WCF アダプターは、本文パス式テキスト ボックスの本文パス式で選択されたノードの外部 XML を使用して BizTalk メッセージ 本文 を作成します。

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

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

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

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

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

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

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

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

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

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

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

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

    型: String

    最大長: 256

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

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

    型: String

    最小長: 0

    最大長: 256

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

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

    型: String

    最小長: 0

    最大長: 256

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

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

参照

SB-Messaging アダプター

アダプターの使用