需通过字段白名单机制防止JSON输入携带未定义字段,配置时设校验模式为白名单模式,在允许字段列表中逐行填写合法路径(如input.text),并启用JSON Schema校验且设置"additionalProperties": false。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在火山引擎大模型应用防火墙中防止JSON输入携带未定义字段,避免非法字段绕过校验或触发异常逻辑,需通过自定义防护规则中的“字段白名单”机制实现严格约束。
配置字段白名单拦截未定义字段
登录大模型应用防火墙控制台 → 在左侧导航栏选择 防护 > 自定义防护 > 字段校验 → 单击 新建字段校验规则。
在规则配置页中,将“校验模式”设为 白名单模式。该模式下仅允许规则中显式声明的字段通过,其余所有字段(包括嵌套路径中的任意新增字段)均会被自动拦截。
在“允许字段列表”文本框中,逐行填写合法字段路径,例如:
input.text
input.user_id
input.metadata.timestamp
output.choices[0].message.content
【必须使用点号(.)和方括号([])准确表达嵌套结构,路径不匹配将导致放行失败】
启用JSON Schema校验(高级场景)
方法一:在字段校验规则中勾选 启用JSON Schema校验 → 点击“编辑Schema” → 直接粘贴符合 Draft-07 规范的 JSON Schema 文本。
方法二:点击“从样例生成Schema” → 粘贴一段典型合法JSON请求体 → 系统自动生成基础Schema → 手动删减冗余字段并设置 "additionalProperties": false。
这一步最关键:若未显式设置 "additionalProperties": false,即使定义了全部已知字段,JSON仍会默认允许额外字段存在。
验证与生效
第一步:在规则配置页底部点击 测试校验 → 输入含未定义字段的JSON样例(如多出 "hack_field":"123")→ 确认返回拦截结果。
第二步:确认规则状态为 启用 → 选择需要绑定的资产(如某AI对话API接口)→ 单击 保存并发布。
第三步:等待约90秒全局策略同步完成,新规则即刻生效。











