HTTP 送信アダプタの設定
概要
送信 HTTP アダプタには以下の設定があります。
グループ | 設定 |
---|---|
基本設定 | [HTTPサーバ]、[HTTPポート]、[URL]、[認証情報] |
接続設定 | [SSL構成]、[SSL チェック・サーバ ID]、[プロキシ・サーバ]、[プロキシ・ポート]、[HTTPSプロキシ]、[HTTP プロキシ・トンネル]、[応答タイムアウト]、[ConnectTimeout] |
追加設定 | Cookie の使用、SendSuperSession |
残りの設定はすべてのビジネス・オペレーションに共通のものです。詳細は、"Ensemble プロダクションの構成" の “すべてのビジネス・オペレーションに含まれる設定” を参照してください。
接続タイムアウト
サーバへの接続が開かれるまで待つ秒数を指定します。デフォルト値は 5 です。
この時間内に接続が開かれない場合、アダプタは、Failure Timeout を Retry Interval で割って得られる回数を上限として再試行を繰り返します。
認証情報
指定された宛先 URL への接続を承認できる Ensemble 資格情報の ID を識別します。Ensemble 認証情報の作成方法は、"Ensemble プロダクションの構成" を参照してください。
HTTPポート
HTTP 要求の送信先となるサーバの TCP ポート (デフォルトでは 80、SSLConfig が指定されている場合は 443 を使用)。これが標準でない場合 (つまり 80 以外の場合)、送信する HTTP 要求の Host: ヘッダに含まれます。前述した “宛先サーバと URL パスの指定” も参照してください。
HTTPサーバ
HTTP 要求の送信先となるサーバの IP アドレス。これは、送信する HTTP 要求の Host: ヘッダで使用されます。前述した “宛先サーバと URL パスの指定” も参照してください。
HTTPSプロキシ
プロキシ (ある場合) が実際の HTTP/HTTPS サーバとの通信に HTTPS を使用するかどうかを指定します。
プロキシ・ポート
プロキシ・サーバを使用する場合、HTTP 要求を送信するプロキシ・サーバ・ポートを指定します (デフォルトでは 8080 を使用します)。
プロキシ・サーバ
HTTP 要求を送信する際に使用するプロキシ・サーバ (ある場合) を指定します。
HTTP プロキシ・トンネル
アダプタが HTTP CONNECT コマンドを使用して、プロキシ経由でターゲットの HTTP サーバへのトンネルを確立するかどうかを指定します。真の場合、要求は HTTP CONNECT コマンドを使用してトンネルを確立します。プロキシ・サーバのアドレスは、[プロキシ・サーバ] および [プロキシ・ポート] の各プロパティから取得されます。HTTPS プロキシが真の場合、トンネルが確立されると、Ensemble は SSL 接続をネゴシエートします。デフォルト値は偽です。
応答タイムアウト
サーバからの応答取得に対するタイムアウトを指定します (サーバへの接続を開く場合のタイムアウトは ConnectTimeout で設定します)。デフォルト値は 30 です。
応答が受信されない場合、アダプタは、Failure Timeout を Retry Interval で割った回数だけ繰り返し再試行します。
SSL チェック・サーバ ID
SSL 接続を行う際に、証明書内のサーバ ID が接続先システムの名前と一致することがアダプタによってチェックされることを指定します。デフォルトでは、このチェックが行われるように指定されます。SSL 証明書で指定された名前が DNS 名と一致しないテスト・システムと開発システムについては、この設定をオフにします。
SSL構成
この接続の認証に使用される既存の SSL/TLS 構成の名前。アダプタが通信を開始するため、クライアント SSL/TLS 構成を選択します。
SSL/TLS 構成を作成して管理するには、管理ポータルを使用します。"Caché セキュリティ管理ガイド" の “Caché での SSL/TLS の使用法” の章を参照してください。[SSL/TLS 構成の編集] フォームの最初のフィールドは [構成名] です。この文字列を [SSL構成] 設定の値として使用します。
SendSuperSession
SendSuperSession はブーリアン設定であり、送信アダプタが HTTP ヘッダ内に SuperSession ヘッダを作成するかどうか、および識別子をそのヘッダに割り当てるかどうかを制御します。メッセージを検索するときに、SuperSession 値を使用して、あるプロダクション内のメッセージを、別のプロダクション内の関連メッセージと突き合わせることができます。プロダクション内では、ビジネス・サービス、プロセス、およびオペレーションの間でメッセージは SessionId を用いて転送されるので、追跡は簡単です。しかし、メッセージが HTTP メッセージによってビジネス・オペレーションからいったん離れ、別のプロダクションに入ると、そのメッセージを受け取ったプロダクションは新しい SessionId を割り当てます。
SendSuperSession を選択すると、HTTP 送信アダプタは以下を実行します。
-
メッセージの Ens.MessageHeaderBase.SuperSession プロパティに空の値があるかどうかを確認します。空の値が含まれている場合、アダプタが新しい値を生成して SuperSession プロパティにそれを格納します。
-
SuperSession プロパティの値を、送信メッセージのプライベート InterSystems.Ensemble.SuperSession HTTP ヘッダに格納します。
HTTP 受信アダプタは、メッセージを受信すると、受信 HTTP メッセージ・ヘッダ内の SuperSession 値を確認します。値が存在する場合、Ens.MessageHeaderBase.SuperSession プロパティを設定します。このプロパティは、メッセージが別のプロダクション・コンポーネントに渡されるときも保持されます。
SuperSession を使用してプロダクション間でのメッセージの追跡を自動化するツールはありません。
URL
サーバから要求するための URL パス (http:// またはサーバ・アドレスを含みません)。
前述した “宛先サーバと URL パスの指定” も参照してください。
Cookie の使用
このアダプタをインスタンス化するときに HTTP 応答で受信される Cookie を保存するどうか、また、その後の各 HTTP 要求に挿入するかどうかを指定します。