文档中心

大模型应用防火墙

防护

配置自定义响应拦截策略

自定义拦截响应是指当大模型应用防火墙拦截恶意请求时，向客户端返回自定义的响应内容，而不是默认的错误页面。您可以在自定义响应内容中告知用户请求被拦截的原因，并提供进一步的指导或帮助，以提升用户体验。本文介绍如何配置自定义拦截响应策略，包括拦截响应方式说明、前提条件以及具体的配置步骤。

响应拦截方式

支持根据响应方式（非流式响应和流式响应）分别配置响应信息，以下是两者的区别：

维度	非流式响应拦截	流式响应拦截
生效对象	防护策略中执行动作为拦截的非流式请求（包括用户提示词和非流式模型响应）	防护策略中执行动作为拦截的流式请求，即流式模型响应
响应方式	一次性输出自定义的拦截响应内容	流式输出自定义的拦截响应内容
配置项	响应码页面模板页面内容/重定向路径页面类型：text/html、text/xml、application/json、text/event-stream	流式响应的替换文本内容
配置效果	输出完整的拦截响应信息。可以返回浏览器页面、结构化数据、SSE 事件流内容，也可以重定向到指定页面。	合规内容以流式方式正常分块输出，自定义的替换文本将替换触发防护策略的内容块，并作为流式输出的最后一个内容块输出。

前提条件

已经配置基础防护策略，例如访问控制策略、提示词攻击防护策略、模型滥用防护策略或敏感数据防护策略，并将策略的执行动作设置为“拦截”。详情请参见防护策略介绍。

操作步骤

登录大模型应用防火墙控制台。

在顶栏选择实例所属地域。

在左侧导航选择防护>自定义拦截响应。

单击添加规则，配置自定义拦截响应参数。

参数	说明	配置示例
规则名称	防护规则名称。说明以中文、字母、数字开头。允许字母、数字、中文、点“.”、下划线“_”和短横线“-”。长度为 1-128 个字符。	拦截响应_1
资产	选择需要匹配的资产 ID或路径。可以针对域名下的路径单独设置，也可以直接勾选域名，使策略生效于域名下所有已添加的路径。说明 SDK 方式接入的防护域名，暂不支持匹配到路径。	www.volcwaf001.com
响应码	设置请求被拦截时返回的响应码。例如，设置为 403 表示禁止访问。	403
页面模板	系统默认：选择系统默认模板，支持text/html、text/xml、application/json、text/event-stream四种页面类型。 text/html：构建浏览器可理解和渲染的用户界面，可以返回一个格式良好且具有良好交互性的网页界面。对应页面内容<!DOCTYPE html> <html> <meta charset="utf-8"> <body> <p> !!! 系统禁止访问 </p> </body> </html>。 text/xml：传输和存储结构化的数据，返回带有标签的结构化数据。对应页面内容<?xml version="1.0" encoding="UTF-8"?><body> !!! 系统禁止访问 </body>。 application/json：用于 Web API 的数据交换，返回纯文本的键值对结构。对应页面内容{"Content":"!!! 系统禁止访问"}。 text/event-stream：用于 Server-Sent Events（SSE）场景，以事件流格式向客户端返回数据。适用于前端原本按流式接口读取响应的场景。页面内容需符合 SSE 格式，事件之间使用空行分隔。对应页面内容示例： data: {"id":"1","object":"chat.completion.chunk",...,"choices":[{"index":0,"delta":{"role":"assistant","content":"对不起，你的问题无法回答"},"finish_reason":null}]} data: {"id":"2","object":"chat.completion.chunk",...,"choices":[{"index":0,"delta":{},"finish_reason":"stop"}]} data: [DONE] 自定义：填写自定义的页面模板，同样支持text/html、text/xml、application/json、text/event-stream四种页面类型，您可以自定义对应内容，请确保自定义内容符合所选页面类型格式要求。说明选择 text/event-stream 时，请确保页面内容包含data:等 SSE 字段，并符合客户端约定的事件格式。重定向：当命中防护策略且执行动作为拦截时，将客户端重定向至防护域名下的指定路径页面。需要填写重定向 path，如/common/info/redirect。	页面模板：自定义页面类型：text/html 页面内容：<!DOCTYPE html> <html> <meta charset="utf-8"> <body> <p> 您没有访问权限，请获取授权后重试。</p> </body> </html>
流式响应开关	流式响应开关开启后，可以在大模型业务的流式响应被拦截后返回特定内容，确保用户体验的连贯性和一致性。	开启
文本内容	配置在请求被拦截时希望返回给用户的文本内容，最多支持 500 个字符。	对不起，我无法回答这个问题。
规则开关	开启或关闭当前规则。	开启

单击确定。

配额说明

单个实例可创建的自定义拦截响应规则总数与实例的资产配额相关，最大为资产配额的 100 倍。达到上限后，新增规则会失败，但不影响已有规则继续生效。您可以删除不再使用的规则后重试；如仍无法满足业务需要，请联系技术支持评估实例配额。

配置效果

大模型应用防火墙的拦截响应效果会根据自定义响应配置的不同状态而变化：

配置状态	非流式请求/响应被拦截	流式响应被拦截
未配置规则或规则关闭	返回默认响应内容	返回默认响应内容
已配置规则但未开启流式响应	返回自定义页面/数据内容或重定向到指定页面	返回自定义页面/数据内容或重定向到指定页面
已配置规则且开启流式响应	返回自定义页面/数据内容或重定向到指定页面	返回预设的自定义流式响应内容

最近更新时间：2026.10.22 21:32:35

这个页面对您有帮助吗？

有用

无用