Citrix ADC

レスポンダーのアクションを構成する

応答側機能を有効にした後、要求を処理するための 1 つ以上のアクションを設定する必要があります。レスポンダーは、次のタイプのアクションをサポートします。

  • Respond with。要求を Web サーバーに転送せずに、Target 式で定義された応答を送信します。(Citrix ADCアプライアンスは、Webサーバーの代わりに使用され、Webサーバーとして機能します)。 このタイプのアクションを使用して、単純な HTML ベースのレスポンスを手動で定義します。通常、Respond with アクションのテキストは、Web サーバーのエラーコードと簡潔な HTML ページで構成されます。

  • Respond with SQL OK。ターゲット式で定義された指定された SQL OK レスポンスを送信します。このタイプのアクションを使用して、SQL OK 応答を SQL クエリに送信します。

  • Respond with SQL Error。ターゲット式で定義された指定された SQL エラー応答を送信します。この種類のアクションを使用して、SQL エラー応答を SQL クエリに送信します。

  • Respond with HTML page。指定された HTML ページを応答として送信します。以前にアップロードされた HTML ページのドロップダウンリストから選択するか、新しい HTML ページをアップロードできます。このタイプのアクションを使用して、インポートされた HTML ページをレスポンスとして送信します。アプライアンスは、responsewithhtmlpage レスポンダーアクションでカスタムヘッダーを使用して応答します。最大 8 つのカスタムヘッダーを構成できます。

  • Redirect。要求を別の Web ページまたは Web サーバーにリダイレクトします。Redirect アクションは、DNS に存在するが、実際の Web サーバーが存在しない「ダミー」の Web サイトに元々送信された要求を、実際の Web サイトにリダイレクトできます。また、検索リクエストを適切な URL にリダイレクトすることもできます。通常、リダイレクトアクションのリダイレクトターゲットは完全な URL で構成されます。

Citrix ADCコマンドラインを使用してレスポンダーのアクションを構成するには:

指定したレスポンダアクションの現在の設定を表示します。アクション名を指定しない場合は、Citrix ADCアプライアンスで現在構成されているすべてのレスポンダーアクションのリストを省略して表示します。

コマンドプロンプトで次のコマンドを入力して、レスポンダーアクションを構成し、構成を確認します。

  • add responder action <name> <type> <target> [-bypassSafetyCheck (YES | NO) ]
  • show responder action

パラメーター:

  • Name。レスポンダアクションの名前。最大長さ:127

  • type。レスポンダアクションのタイプ。次のようになります。(応答します)。

  • ターゲット。応答するものを指定する式

  • htmlpage. htmlpageで応答するように指定するオプション

  • bypassSafetyCheck。安全でない式を許可する安全性チェック。注: この属性は非推奨です。

  • hits。アクションが実行された回数。

  • referenceCount。アクションへの参照の数。

  • undefHits。アクションの結果が UNDEF になった回数。

  • コメントです。このレスポンダーのアクションに関するあらゆる種類の情報。

  • builtin。レスポンダアクションが組み込まれているかどうかを判断するフラグ

例:

To create a responder action that displays a “Not Found” error page for URLs that do not exist:

> add responder action act404Error respondWith '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done

> show responder action

1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done

To create a responder action that displays a “Not Found” error page for URLs that do not exist:

add responder action act404Error respondWith '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action

1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done

Citrix ADCコマンドラインを使用して既存のレスポンダーアクションを変更するには:

コマンドプロンプトで次のコマンドを入力して、既存のレスポンダーアクションを変更し、構成を確認します。

  • set responder action <name> -target <string> [-bypassSafetyCheck ( YES | NO )]
  • show responder action

例:

set responder action act404Error  -target '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
 Done
> show responder action

1)      Name: act404Error
        Operation: respondwith
        Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
        BypassSafetyCheck : NO
        Hits: 0
        Undef Hits: 0
        Action Reference Count: 0
 Done

Citrix ADCコマンドラインを使用してレスポンダーのアクションを削除するには:

コマンドプロンプトで次のコマンドを入力して、レスポンダーアクションを削除し、構成を確認します。

  • rm responder action <name>
  • show responder action

例:

rm responder action act404Error
 Done

> show responder action
 Done

Citrix ADCコマンドラインを使用して、レスポンダーアクションにカスタムヘッダーを追加するには、次の手順に従います。

Citrix ADC アプライアンスは、レスポンダーアクションでカスタムヘッダーを使用して応答できるようになりました。最大 8 つのカスタムヘッダーを構成できます。以前は、アプライアンスはContent-type:text/htmlContent-Length:<value> 静的ヘッダーでのみ応答していました。

注:

カスタムヘッダー構成では、「Content-Type」ヘッダー値を上書きすることもできます。

コマンドプロンプトで、次のコマンドを入力します。

add responder action <name> <type> (<target> | <htmlpage>) [-comment <string>] [-responseStatusCode <positive_integer>] [-reasonPhrase <expression>] [-headers <name(value)> ...]

各項目の意味は次のとおりです。

名を入力します。レスポンダアクションの名前。文字、数字、またはアンダースコア文字 (_) で始まり、文字、数字、ハイフン (-)、ピリオド (.) ハッシュ (#)、スペース ()、アットマーク (@)、等しい (=)、コロン (:)、およびアンダースコア文字のみを含める必要があります。レスポンダーポリシーの追加後に変更できます。

タイプ。レスポンダアクションのタイプ。使用可能な設定は次のように機能します。

  1. respondwith<target> -ターゲットとして指定された式でリクエストに応答します。
  2. respondwithhtmlpage-アップロードされたHTMLページオブジェクトをターゲットとして指定してリクエストに応答します。
  3. redirect-ターゲットとして指定された URL にリクエストをリダイレクトします。
  4. sqlresponse_ok-SQL OKレスポンスを送信します。
  5. sqlresponse_error-SQLエラーレスポンスを送信します。これは必須の引数です。可能な値:noop、応答、リダイレクト、応答ページへの返信、sqlresponse_ok、sqlresponse_error

ターゲット。応答する内容を指定する式。通常、リダイレクトポリシーの URL またはデフォルトの構文式です。リクエスト内の情報を参照する Citrix ADC のデフォルト構文式に加えて、 ストリングビルダー式には、テキストと HTML、および新しい行と段落を定義する単純なエスケープコードを含めることができます。各ストリングビルダーの式 要素(Citrix ADC デフォルト構文式または文字列)を二重引用符で囲みます。要素を結合するには、プラス (+) 文字を使用します。

htmlpage。応答のhtmlpage ポリシーの場合、応答として使用する HTML ページオブジェクトの名前。最初にページオブジェクトをインポートする必要があります。最大長さ:31

[コメント]: このレスポンダーのアクションに関するあらゆる種類の情報。最大長:255

responseStatusCode。HTTP 応答ステータスコード (例:200、302、404 など) リダイレクトアクションタイプの デフォルト値は 302 で、応答withhtmlpage の場合は 200 です。最小値:100 最大値:599

reasonPhrase。HTTP レスポンスの理由フレーズを指定する式。reason フレーズは、引用符で囲まれた文字列リテラルまたは PI 式です。たとえば、「無効な URL:” + HTTP.REQ.URL の最大長は 8191 です。

[ヘッダ] HTTP レスポンスに挿入する 1 つ以上のヘッダー。各ヘッダーは「name (expr)」として指定されます。expr は、実行時に評価され、名前付きヘッダーの値を提供する式です。レスポンダーアクションには、最大 8 つのヘッダーを構成できます。

GUI を使用してレスポンダアクションを構成するには、次の手順を実行します。

  1. AppExpert > レスポンダー > アクションに移動します。
  2. 詳細ウィンドウで、次のいずれかの操作を行います。
    • アクションを作成するには、[追加] をクリックします。
    • 既存のアクションを変更するには、アクションを選択し、[開く] をクリックします。
  3. アクション を作成 するか、既存のアクションを修正するかによって、「作成」(Create) または「 OK」(OK) をクリックします。
  4. [閉じる] をクリックします。ステータスバーに、機能が有効になっていることを示すメッセージが表示されます。
  5. 応答側のアクションを削除するには、アクションを選択し、[削除] をクリックします。ステータスバーに、機能が無効になったことを示すメッセージが表示されます。

[式の追加] ダイアログボックスを使用して 式を追加するには

  1. [レスポンダーアクションの作成] または [レスポンダーアクションの構成] ダイアログボックスで、[追加] をクリックします。

  2. [式の追加] ダイアログボックスの最初のリストボックスで、式の最初の用語を選択します。
    • HTTP. HTTP プロトコル。HTTP プロトコルに関連するリクエストの側面を調べる場合は、これを選択します。
    • SYS. 1 つ以上の保護された Web サイトリクエストの受信者に関連するリクエストの側面を調べる場合は、これを選択します。
    • CLIENT。要求を送信したコンピュータ。リクエストの送信者の一部を調べる場合は、これを選択します。
    • ANALYTICS. リクエストに関連付けられた分析データ。リクエストメタデータを調べる場合は、これを選択します。
    • SIP. SIP 要求。SIP 要求の一部の側面を調べる場合は、これを選択します。選択すると、右端のリストボックスには、式の次の部分に適した用語が一覧表示されます。
  3. 2 番目のリストボックスで、式の 2 番目の項を選択します。選択内容は、前のステップで行った選択内容によって異なり、コンテキストに適切です。2 番目の選択を行うと、[式を構築] ウィンドウの下にある [ヘルプ] ウィンドウ (空白) に、選択した用語の目的と使用方法を示すヘルプが表示されます。
  4. 式が終了するまで、前のリストボックスの右側に表示されるリストボックスから用語を選択するか、値の入力を求めるテキストボックスに文字列または数値を入力します。

グローバル HTTP アクションの設定

HTTP 要求がタイムアウトしたときにレスポンダアクションを呼び出すように、グローバル HTTP アクションを設定できます。この機能を設定するには、最初に呼び出すレスポンダアクションを作成する必要があります。次に、そのレスポンダーアクションでタイムアウトに応答するように、グローバル HTTP タイムアウトアクションを設定します。

Citrix ADCコマンドラインを使用してグローバルHTTPアクションを構成するには:

コマンドプロンプトで、次のコマンドを入力します。

  • set ns httpProfile -reqTimeoutAction <responder action name>
  • save ns config

<responder action name>で、レスポンダアクションの名前を置き換えます。

HTML ページのインポートの設定

Citrix ADCアプライアンスは、カスタムメッセージで応答すると, 我々は、HTMLファイルで応答することができます. コマンドを使用してファイルをインポートし、import responder htmlpage このファイルをadd responder action <act name> respondwithhtmlpage <file name> コマンドで使用することができます。Citrix ADC GUIを使用してファイルをインポートすることもできます。必要な HTML ページをアプライアンスフォルダにインポートし、レスポンダの実行時にページをアップロードできます。

CLI を使用した HTML ページのインポート

コマンドプロンプトで、次のように入力します。

import responder htmlpage [<src>] <name> [-comment <string>] [-overwrite][-CAcertFile <string>]

例:

import responder htmlpage http://www.example.com/page.html my-responder-page -CAcertFile my_root_ca_cert

ここで、 CA証明書は、クライアント証明書の検証に使用されます。証明書は、「import ssl certfile」CLIコマンドを使用してインポートするか、APIまたはGUIを介して同等の方法でインポートする必要があります。証明書名が構成されていない場合は、デフォルトのルート CA 証明書が証明書の検証に使用されます。

Citrix ADC GUIを使用してHTMLページをインポートする

  1. AppExpert >レスポンダー >HTMLページのインポートに移動します。
  2. レスポンダー HTML インポート の詳細ウィンドウで、[追加] をクリックします。
  3. HTMLページのインポート・オブジェクト ・ページで、次のパラメータを設定します。

    1. Name。HTML ページの名前。
    2. [読み込み元]: ファイル、テキスト、またはテキストから読み込まれます。
    3. URL。HTML ファイルの URL の場所を入力するために選択します。
    4. File。アプライアンスのディレクトリから HTML ファイルを選択します。
    5. Text。HTML ファイルをテキストとして選択します。
  4. [続行] をクリックします。
  5. レスポンダの HTML ページの詳細を確認します。
  6. [完了] をクリックします。

    HTML ページのインポート

HTML ページを編集するには、ファイルを選択し、[アクションの選択] ドロップダウンリストから [レスポンダー HTML ページファイルの編集] をクリックします。

レスポンダーHTMLページファイルの編集

レスポンダーのアクションを構成する