HTTP アダプター構成プロパティ
次の表に、HTTP アダプターの受信場所に設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 | 制限 | 説明 |
|---|---|---|---|---|
| ReturnCorrelationHandle | VT_BOOL | 成功時に、クライアントに対する HTTP 応答で送信されたメッセージの関連付けトークンを受信場所から送信することを指定します。 | このプロパティは、一方向の受信場所に対してのみ有効です。 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
なし |
| ResponseContentType | VT_BSTR | 受信場所からクライアントに返送される HTTP 応答メッセージのコンテンツの種類を指定します。 | このプロパティは、要求 - 応答の受信場所に対してのみ有効です。 最小長: 0 最大長: 256 |
既定値は、text/xml です。 |
| SuspendFailedRequests | VT_BOOL | 受信処理に失敗した HTTP 要求を中断するかどうかを指定します。 | 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
値を 0 (false) に設定すると、失敗した要求は破棄され、エラー状態コード (401 または 500) がクライアントに送信されます。 値を -1 (true) に設定すると、失敗した要求は中断されます。また、一方向の受信ポートの場合はクライアントに "受理" 状態コード (200) が送信され、双方向の受信ポートの場合はクライアントに "エラー" 状態コード (500) が送信されます。 既定値は 0 (false) です。 |
| UseSSO | VT_BOOL | エンタープライズ シングル サインオンを使用するように指定します。 | 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
既定値は 0 (false) です。 |
| LoopBack | VT_BOOL | この場所で受信した要求メッセージが、応答として送信される送信ポートまたはこの受信場所にルーティングされるように指定します。 | このプロパティは、要求 - 応答の受信場所に対してのみ有効です。 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
既定値は 0 (false) です。 |
次のコード例は、プロパティの設定に使用する XML 文字列の形式を示しています。
<CustomProps>
<ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>
<ResponseContentType vt="8">text/xml</ResponseContentType>
<SuspendFailedRequests vt="11">-1</SuspendFailedRequests>
<UseSSO vt="11">-1</UseSSO>
<LoopBack vt="11">-1</LoopBack>
</CustomProps></
次の表に、HTTP アダプターの送信ポートに設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 | 制限 | 説明 |
|---|---|---|---|---|
| ProxyPort | VT_I4 | この送信ポートのプロキシ サーバー ポートを指定します。 | 有効な値は 0 から 65535 です。 | UseProxy プロパティが 0 (false) に設定されている場合、このプロパティの値は必要ありません。 既定値は 80 です。 |
| RequestTimeout | VT_I4 | HTTP/HTTPS 送信のタイムアウトを秒単位で指定します。 | 有効値は、0 ～ MAX_LONG です。 | この時間内に HTTP アダプタが応答を受信しない場合、サービスによりエラーがログに記録され、再試行インフラストラクチャに基づいてメッセージが再送信されます。 0 に設定されている場合、タイムアウト値は要求メッセージのサイズを基準に計算されます。 値を設定しないと、ハンドラの値が使用されます。 |
| Certificate | VT_BSTR | SSL (Secure Sockets Layer) 接続の確立に使用するクライアント証明書の拇印を指定します。 | 最小長: 0 最大長: 59 |
既定値は空です。 |
| AuthenticationScheme | VT_BSTR | 接続先のサーバーで使用する認証の種類を指定します。 | 有効な値は次のとおりです。 -匿名 -基本的な -ダイジェスト -Kerberos |
既定値は "Anonymous" です。 |
| ユーザー名 | VT_BSTR | 接続先のサーバーで認証に使用するユーザー名を指定します。 | [基本] または [ダイジェスト] の AuthenticationScheme が使用されており、かつエンタープライズ シングル サインオンが使用されていない場合は、このプロパティに値を設定する必要があります。 最小長: 0 最大長: 256 |
なし |
| EnableChunkedEncoding | VT_BOOL | チャンク エンコードを使用するために指定します。 | HTTP 送信ハンドラーで [プロキシを使用する] を有効にしている場合、チャンク エンコードは暗黙的に無効になります。 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
このオプションを有効にすると、HTTP アダプターは最大チャンク サイズが 8 Kb の HTTP チャンク エンコードを使用します。 既定値は 0 (false) です。 |
| UseProxy | VT_BOOL | HTTP 送信ハンドラーがプロキシ サーバーを使用するかどうかを指定します。 | 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
既定値は 0 (false) です。 |
| ProxyName | VT_BSTR | この送信ポートのプロキシ サーバー アドレスを指定します。 | 最小長: 0 最大長: 256 |
UseProxy プロパティが 0 (false) に設定されている場合、このプロパティの値は必要ありません。 |
| UseSSO | VT_BOOL | 接続先のサーバーでの認証でクライアントの資格情報を取得する際に、シングル サインオンを使用するかどうかを指定します。 | 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
既定値は 0 (false) です。 |
| パスワード | VT_NULL | 接続先サーバーでの認証に使用するパスワードを指定します。 | [基本] または [ダイジェスト] の AuthenticationScheme が使用されており、かつエンタープライズ シングル サインオンが使用されていない場合は、このプロパティに値を設定する必要があります。 バインド ファイルをエクスポートする場合は、この値を必ず Null に設定します。 ターゲットの BizTalk Server 構成にバインド ファイルをインポートする前に、このフィールドにパスワードを手動で設定する必要があります。 最小長: 0 最大長: 256 |
このフィールドに値を指定した場合は、このプロパティの型を VT_BSTR (vt="8") に設定してからバインド ファイルをインポートします。 |
| MaxRedirects | VT_I4 | 送信されるメッセージに許可されるリダイレクトの最大数を指定します。 | 有効な値は 0 から 10 です。 | 既定値は 5 です。 |
| ContentType | VT_BSTR | 要求メッセージのコンテンツの種類を指定します。 | 最小長: 0 最大長: 256 |
この値が設定されていない場合、ハンドラの値が使用されます。 |
| ProxyPassword | VT_NULL | プロキシ サーバーで認証に使用するユーザー パスワードを指定します。 | バインド ファイルをエクスポートする場合は、この値を必ず Null に設定します。 ターゲットの BizTalk Server 構成にバインド ファイルをインポートする前に、このフィールドにパスワードを手動で設定する必要があります。 最小長: 0 最大長: 256 |
UseProxy プロパティが 0 (false) に設定されている場合、このプロパティの値は必要ありません。 |
| ProxyUsername | VT_BSTR | プロキシ サーバーを使用した認証のユーザー名を指定します。 | 最小長: 0 最大長: 256 |
UseProxy プロパティが 0 (false) に設定されている場合、このプロパティの値は必要ありません。 |
| UseHandlerSetting | VT_BOOL | 送信ポートの構成で、HTTP 送信ハンドラーに指定したプロキシ設定を使用することを指定します。 | 有効な値は次のとおりです。 - -1 (true) - 0 (false) |
既定値は -1 (true) です。 |
次のコード例は、プロパティの設定に使用する XML 文字列の形式を示しています。
<CustomProps>
<ProxyPort vt="3">80</ProxyPort>
<RequestTimeout vt="3">60</RequestTimeout>
<Certificate vt="8">A7 6D F9 06 5E FC 97 66 75 59 B5 D6 67 0C 84 DC 64 F5 BF B9</Certificate>
<AuthenticationScheme vt="8">Basic</AuthenticationScheme>
<Username vt="8">authenticateduser</Username>
<EnableChunkedEncoding vt="11">-1</EnableChunkedEncoding>
<UseProxy vt="11">-1</UseProxy>
<ProxyName vt="8">proxyserver</ProxyName>
<UseSSO vt="11">0</UseSSO>
<Password vt="1" />
<MaxRedirects vt="3">5</MaxRedirects>
<ContentType vt="8">text/xml</ContentType>
<ProxyPassword vt="1" />
<ProxyUsername vt="8">proxyuser</ProxyUsername>
<UseHandlerSetting vt="11">0</UseHandlerSetting>
</CustomProps>