ADC

自定义 HTML、XML 和 JSON 错误对象的错误状态和消息

当 Citrix Web App Firewall 检测到违规时,设备会使用重定向 URL 或错误对象(导入到配置文件中并启用)处理错误场景。如果使用错误对象配置处理场景,WAF 配置文件将提供自定义响应状态代码和消息。您可以在 WAF 配置文件中自定义 HTML、XML 或 JSON 错误对象的响应错误详细信息。

注意 : 默认情况下,如果配置了错误对象设置,则错误代码和错误消息设置为 “200” 和 “确定”。

在处理错误情况时,设备必须使用适当的 HTTP 响应状态代码和消息进行响应,以解决问题。通过提供自定义错误状态消息和自定义错误状态代码,设备可以在发生违规时提供更好的用户干预来解决问题。 例如,如果将响应错误代码设置为 “404”,将状态消息设置为 “未找到”,则用户可以检查响应状态代码和消息以检查是否发生了违规。这可以帮助用户筛选包含错误对象的响应

使用 CLI 为 WAF 配置文件中的 HTML 错误对象配置自定义状态代码和消息

在命令提示符下,键入:

set appfw profile <profile-name> -HTMLErrorStatusCode <value> -HTMLErrorStatusMessage <value> -useHTMLErrorObject ON
<!--NeedCopy-->

示例:

set appfw profile profile_1 -HTMLErrorStatusCode 404 -HTMLErrorStatusMessage “Not Found” -useHTMLErrorObject ON

使用 CLI 为 WAF 配置文件中的 XML 错误对象配置自定义状态代码和消息

在命令提示符下,键入:

set appfw profile <profile-name> -XMLErrorStatusCode <value> -XMLErrorStatusMessage <value>
<!--NeedCopy-->

示例:

set appfw profile profile_1 -XMLErrorStatusCode 406 - XMLErrorStatusMessage “Not Acceptable”

使用 CLI 为 WAF 配置文件中的 JSON 错误对象配置自定义状态代码和消息

在命令提示符下,键入:

set appfw profile <profile-name> -JSONErrorStatusCode <value> -JSONErrorStatusMessage <value>
<!--NeedCopy-->

示例:

set appfw profile profile_1 -JSONErrorStatusCode 500 - JSONErrorStatusMessage “Internal Server Error”

使用 GUI 为 WAF 配置文件中的 HTML、JSON 或 XML 错误对象配置自定义状态代码和消息

  1. 导航到安全 > Citrix Web App Firewall > 配置文件
  2. 在详细信息窗格中,单击 编辑
  3. 创建 Web App Firewall 配置文件 页面中,单击 高级设置部分中的配置 文件设置
  4. 配置文件设置 部分中,设置以下参数。

    a. HTML 错误对象。选择使用 HTML 错误对象处理错误方案的选项。从 URL、文件或文本导入错误对象。 b. HTML 错误状态代码。提供自定义错误状态代码。 c. HTML 错误状态消息。提供客户错误消息。

  5. 点击 确定完成

注意 : 同样的过程也适用于 JSON 和 XML 自定义错误对象设置。

Citrix Web App Firewall HTML、XML 和 JSON 错误对象的自定义错误状态和消息