大模型应用防火墙
大模型应用防火墙
文档指南
请输入
- 文档首页
大模型应用防火墙用户指南资产管理模型接入配置模型接入参数
复制全文
下载 pdf配置模型接入参数
文档反馈
问问助手大模型应用防火墙可以根据不同的模型平台类型，结合 API Key 和访问域名、源站配置等信息，与客户端和您的后端服务器进行流量通信，并对流量进行检测，确保业务安全稳定运行。 本文主要介绍如何配置不同模型的接入参数。
前提条件
注意事项
API Key 需符合Authorization: Bearer <API Key>样式，否则会导致鉴权失败，流量无法通过。
操作步骤
- 登录大模型应用防火墙控制台。
- 在顶栏选择实例所属地域。
- 在左侧导航选择资产管理，然后单击添加资产。
- 选择接入方式为模型服务接入，并配置相关参数信息。
-
- 基本信息：基本信息用于标识接入大模型应用防火墙的具体业务。
- 参数说明资产名称您自定义的资产名称，用于在防火墙控制台区分不同的接入资产。说明
- 以中文、字母或数字开头。
- 允许使用中文、字母、数字、点（.）、下划线（_）和中划线（-）。
- 长度为 1-100 个字符。
资产 ID提交后由平台自动生成，用于唯一标识当前资产；创建时无需填写。描述对该接入资产的补充说明。联系人资产的业务或运维联系人，用于识别该资产的负责人。
- 外部对接信息：用于记录当前资产与外部系统中对应资产之间的映射关系。
- 参数说明外部对接方式支持选择不绑定或人工绑定。不绑定时，无需配置外部资产信息；人工绑定时，需要配置当前资产在外部系统中的对应信息。通过 HiAgent 接入的资产会自动同步外部对接信息，无需手动绑定。外部系统标识用于标识资产所属的外部系统。该字段与平台生成的资产 ID 不同。外部资产类型用于记录资产在外部系统中的业务类型。该字段不表示 SDK 接入、流量接入或模型服务接入等平台接入方式。外部资产名资产在外部系统中的名称，用于核对两侧资产的对应关系。外部资产 ID资产在外部系统中的唯一标识。选择人工绑定时必填；选择不绑定时无需填写。通过 HiAgent 接入时由系统自动同步。
注意
通过 HiAgent 接入的资产，其外部对接信息由系统自动同步，不能手动修改。
- 模型配置：模型配置参数决定了大模型应用防火墙如何准确地识别和提取请求中的提示词和响应中的大模型输出，是进行深度内容安全检测的基础。控制台按模型提供方对可选模型服务进行分组；请先选择实际使用的模型提供方，再根据模型类型完成对应配置。具体如下：
-
- 模型服务域名：输入您提前获取的机器学习平台服务域名。例如获取的机器学习平台公网访问地址为https://scv8****.apigateway-cn-shanghai.volceapi.com/mlp/s-20250311190045-rbjcf/，则填入scv8****.apigateway-cn-shanghai.volceapi.com。获取方式请参考获取机器学习平台服务域名。
- 防护域名：平台自动生成防护域名，业务请求将被牵引至该域名下进行检测，检测后的数据会被转发至机器学习平台处理。您需要将原有访问域名替换为大模型应用防火墙提供的防护域名，将业务流量牵引至大模型应用防火墙进行防护。
- 自定义防护路径：根据模型类型配置对应的防护路径，确保请求能够准确地被引导至相应的防护机制下进行处理。
- 类型：选择后端服务的接口协议标准，系统已预置主流大模型的兼容协议。不同的主流大模型在接收用户输入和返回响应时，其 JSON 结构、参数名称、数据类型等可能存在差异。例如，OpenAI 的 API 可能使用 messages 数组来封装对话内容，而其他模型可能直接使用 prompt 字段。请从下拉菜单中选择：
- OpenAI Chat Completions 兼容：适用于标准的对话接口。支持模型包括：豆包 (Doubao)、OpenAI、DeepSeek (深度求索)、Qwen (通义千问)。
- OpenAI Responses API 兼容：适用于标准的响应接口。支持模型包括：豆包 (Doubao)、OpenAI。
- Qwen DashScope 模型：适用于阿里云通义千问 DashScope 原生协议。
- 自定义应用类型：如果您的大模型业务不属于以上适配的应用类型，或者您需要进行更高级的自定义解析，则需要选择自定义应用类型，并且导入 schema 来完成接入。自定义应用配置的相关说明请参考配置自定义应用类型。
注意自定义应用类型仅支持检测文本内容。- 路径：将公网访问地址的路径部分与 API 请求路径拼接后填写。
- 例如公网访问地址为https://scv8****.apigateway-cn-shanghai.volceapi.com/mlp/s-20250311190045-rbjcf，API 请求路径为/v1/chat/completions，则填写/mlp/s-20250311190045-rbjcf/v1/chat/completions。
- 一个大模型应用可能提供多个 API 接口（例如：/v1/chat/completions 用于对话，/v1/embeddings 用于生成向量）。防火墙可以针对不同路径的 API 接口配置不同的防护策略，满足多样化的安全需求。
- 自定义送检内容：
- 自定义送检内容用于指定大模型应用中需要指定的检测内容，即 Content 字段。
- 您的 Content 字段内可能包含了系统提示词和用户历史输入内容，配置自定义送检可以过滤非用户输入或历史内容，提升检测的准确性和效率。
- 支持通过前后缀匹配来定位需要送检的内容，当涉及多个相同的前后缀匹配内容时（例如多轮历史对话），您也可以设置仅送检匹配的第一条、最后一条或所有条目。
- 方舟应用 API Key：输入您提前获取的方舟应用 API Key，获取方式参考获取方舟应用 API Key。
- 方舟域名：方舟平台对外提供服务的统一域名。
- 防护域名：平台自动生成防护域名，业务请求将被牵引至该域名下进行检测，检测后的数据会被转发至方舟平台处理。您需要将原有访问域名替换为大模型应用防火墙提供的防护域名，将业务流量牵引至大模型应用防火墙进行防护。
- 模型应用 API Key：输入您提前获取的模型应用 API Key，获取方式参考对应模型服务的官方文档。
- 模型服务域名：模型服务平台对外提供服务的统一域名。
- 防护域名：平台自动生成防护域名，业务请求将被牵引至该域名下进行检测，检测后的数据会被转发至您的模型服务处理。您需要将原有访问域名替换为大模型应用防火墙提供的防护域名，将业务流量牵引至大模型应用防火墙进行防护。
- 自定义防护路径：根据模型类型配置对应的防护路径，确保请求能够准确地被引导至相应的防护机制下进行处理。
- 选择后端服务的接口协议标准，系统已预置主流大模型的兼容协议。不同的主流大模型在接收用户输入和返回响应时，其 JSON 结构、参数名称、数据类型等可能存在差异。例如，OpenAI 的 API 可能使用 messages 数组来封装对话内容，而其他模型可能直接使用 prompt 字段。请从下拉菜单中选择：
- OpenAI Chat Completions 兼容：适用于标准的对话接口。支持模型包括：豆包 (Doubao)、OpenAI、DeepSeek (深度求索)、Qwen (通义千问)。
- OpenAI Responses API 兼容：适用于标准的响应接口。支持模型包括：豆包 (Doubao)、OpenAI。
- Qwen DashScope 模型：适用于阿里云通义千问 DashScope 原生协议。
- 自定义应用类型：如果您的大模型业务不属于以上适配的应用类型，或者您需要进行更高级的自定义解析，则需要选择自定义应用类型，并且导入 schema 来完成接入。自定义应用配置的相关说明请参考配置自定义应用类型。
注意自定义应用类型仅支持检测文本内容。- 路径：客户端向大模型应用 API 发送请求时，URL 中除去域名和端口后的精确路径。一个大模型应用可能提供多个 API 接口（例如：/v1/chat/completions 用于对话，/v1/embeddings 用于生成向量）。防火墙可以针对不同路径的 API 接口配置不同的防护策略，满足多样化的安全需求。
- 源站配置：源站配置参数用于控制大模型应用防火墙与后端服务器之间的连接行为，如无特殊需要，保持默认值即可。
-
- 单击下一步。
- 页面会返回防护域名的大模型防护策略默认配置选项。你可以在此处快速配置，或者直接前往策略配置页面进行详细配置。
- 对应策略的详细介绍和配置说明可参见防护策略介绍。
-
后续操作
完成配置后，您需要将原有模型业务的访问域名替换为大模型应用防火墙提供的防护域名，将业务流量牵引至大模型应用防火墙进行防护。
说明
替换域名时，需要将原请求路径保持不变。例如，如果您接入前的请求路径为模型服务域名/api/v3/bots，接入后需要替换为大模型应用防火墙提供的防护域名/api/v3/bots。
以下提供两种模型服务的 Python SDK 配置示例，您可以根据实际应用的模型服务类型和调用方式修改对应的域名。
以火山引擎方舟 Python SDK 为例
以阿里云百炼平台 OpenAI Python SDK 为例
最近更新时间：2026.10.22 21:32:35
这个页面对您有帮助吗？
有用
有用
无用
无用