この記事は機械翻訳されています.免責事項
HTML、XML、および JSON エラーオブジェクトのカスタムエラーステータスとメッセージ
NetScaler Web App Firewallが違反を検出すると、アプライアンスはリダイレクトURLまたはエラーオブジェクト(プロファイルにインポートされ、有効化)を使用してエラーシナリオを処理します。シナリオがエラーオブジェクト設定を使用して処理される場合、WAF プロファイルはカスタム応答ステータスコードとメッセージを提供します。WAF プロファイルの HTML、XML、または JSON エラーオブジェクトの応答エラーの詳細をカスタマイズできます。
注:
デフォルトでは、エラーオブジェクトの設定が構成されている場合、エラーコードとエラーメッセージは「200」および「OK」に設定されます。
エラーシナリオを処理する場合、問題を解決するために、アプライアンスが適切な HTTP 応答ステータスコードとメッセージで応答することが重要です。カスタムのエラーステータスメッセージとカスタムエラーステータスコードを提供することにより、アプライアンスは、違反が発生したときに問題を解決するためのユーザー介入を向上させることができます。 たとえば、応答エラーコードを「404」に設定し、ステータスメッセージを「Not Found」に設定すると、ユーザーは応答ステータスコードとメッセージを検査して、違反が発生したかどうかを確認できます。これにより、エラーオブジェクトを含む応答をフィルタリングできます。
CLI を使用して、WAF プロファイル内の HTML エラーオブジェクトのカスタムステータスコードとメッセージを設定します
コマンドプロンプトで入力します。
set appfw profile <profile-name> -HTMLErrorStatusCode <value> -HTMLErrorStatusMessage <value> -useHTMLErrorObject ON
例:
set appfw profile profile_1 -HTMLErrorStatusCode 404 -HTMLErrorStatusMessage “Not Found” -useHTMLErrorObject ON
CLI を使用して、WAF プロファイルの XML エラーオブジェクトのカスタムステータスコードとメッセージを設定する
コマンドプロンプトで入力します。
set appfw profile <profile-name> -XMLErrorStatusCode <value> -XMLErrorStatusMessage <value>
例:
set appfw profile profile_1 -XMLErrorStatusCode 406 - XMLErrorStatusMessage “Not Acceptable”
CLI を使用して WAF プロファイルの JSON エラーオブジェクトのカスタムステータスコードとメッセージを構成する
コマンドプロンプトで入力します。
set appfw profile <profile-name> -JSONErrorStatusCode <value> -JSONErrorStatusMessage <value>
例:
set appfw profile profile_1 -JSONErrorStatusCode 500 - JSONErrorStatusMessage “Internal Server Error”
GUI を使用して WAF プロファイルの HTML、JSON、または XML エラーオブジェクトのカスタムステータスコードとメッセージを構成します
- [ セキュリティ]> NetScaler Web App Firewall]>[プロファイル]に移動します。
- 詳細ウィンドウで、[ 編集] をクリックします。
- [ Web App Firewall プロファイルの作成 ] ページで、[ 詳細設定] セクションの [プロファイル設定] をクリックします。
-
[ プロファイル設定] セクションで、次のパラメータを設定します。
a. HTML エラーオブジェクト。HTML エラーオブジェクトを使用してエラーシナリオを処理するオプションを選択します。URL、ファイル、またはテキストからエラーオブジェクトをインポートします。 b. HTML エラーステータスコード。カスタムエラーステータスコードを指定します。 c. HTML エラーステータスメッセージ。カスタマーのエラーメッセージを入力します。
- [OK] をクリックし、[完了] をクリックします。
注:
JSON および XML カスタムエラーオブジェクト設定にも同じ手順が適用されます。