目的地的安全与限制
Dcision 如何保护出站请求——仅限 https、SSRF 防护、不跟随重定向、密钥——每种目的地类型发送和存储什么、谁可以配置什么,以及所有目的地限制。
出站请求
Webhook、API 请求、工作流和智能体会调用你配置的 URL,因此 Dcision 会保护每一个连接:
- 仅限 https。URL 以
https://开头,或以保存完整 URL 的密钥开头。http://URL 在保存时就会被拒绝。 - 仅限公网地址。主机名在 Dcision 建立连接时解析,并且每个地址都在那一刻、在连接内部进行检查——一个名称不可能在检查时解析为公网地址、在请求时又解析为私有地址。字面 IP 地址同样会被检查。
- URL 中不能包含凭据。
https://user:password@…会被拒绝:请把凭据放在请求头中,并使用密钥。 - 不跟随重定向。
3xx响应被视为投递失败;Dcision 从不跟随它。 - 短且有界。每次投递尝试 10 秒(LLM 和
sync智能体调用最多 25 秒),响应最多读取 64 KB。
被拦截的地址:
| 范围 | 说明 |
|---|---|
0.0.0.0/8 | “本”网络 |
10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 | 私有网络 |
100.64.0.0/10 | 运营商级 NAT |
127.0.0.0/8 | 环回 |
169.254.0.0/16 | 链路本地,包括云元数据服务 |
192.0.0.0/24、192.0.2.0/24、192.88.99.0/24、198.18.0.0/15、198.51.100.0/24、203.0.113.0/24 | 保留、测试和基准测试范围 |
224.0.0.0/4、240.0.0.0/4 | 组播、保留和广播 |
::、::1、fc00::/7、fe80::/10、fec0::/10、ff00::/8、2001:db8::/32、100::/64 | IPv6 未指定地址、环回、唯一本地、链路本地、站点本地、组播、文档和丢弃地址 |
IPv4 映射、IPv4 兼容、NAT64(64:ff9b::/96)和 6to4(2002::/16)地址 | 当其内含的 IPv4 地址被拦截时也被拦截 |
以 .local、.internal 或 .localdomain 结尾的主机名——以及解析为任何被拦截地址的名称,例如内部服务名——同样会被拒绝。
密钥
- 工作区密钥使用 AES-256-GCM 加密,永远不会出现在决策 schema、响应、执行日志或 Playground 中——预览会将其遮蔽为
••••。 - 你的请求头的值永远不会写入 Dcision 的日志;不过仍请把 token 放在密钥中,因为应用会显示每次投递请求的遮蔽预览,其中包括请求头。
- 签名密钥同样被加密,只有管理员和所有者可以显示或轮换它。
什么会离开 Dcision
| 类型 | 接收方得到什么 |
|---|---|
reply | 什么都不会离开:文本返回给调用方。 |
function | 什么都不会离开:函数名称和 params 返回给调用方。 |
llm | 模型提供商——在你的密钥和账户下——得到路由的提示词和输入:除非你设置了 input,否则是整个 state。 |
agent | 你的智能体得到作为 input 的整个 state、指令、工具、params 以及决策的回答。 |
webhook | 回答、置信度、加权等级、复合指标、行动、原因和 params——从不包含 state。 |
workflow | params 和决策的回答——从不包含 state。 |
http | 正好是你的 URL、请求头和请求体模板所包含的内容。 |
只映射接收方需要的内容:params 是目的地的数据最小化工具。
Dcision 存储什么
- 执行记录保留本次运行的
destinations条目——包括函数 params、固定回复、LLM 文本和智能体回答——无论决策的storeInput和storeOutput设置如何。它们遵循执行记录的日志保留期,并出现在GET /v1/executions中。如果 params 携带个人数据,这些条目也会包含。 - 投递保留其状态、尝试次数、响应的状态码、延迟和前 1,024 个字符、请求的遮蔽预览——方法、URL、请求头和请求体大小,从不包含请求体——以及在可能重新发送期间加密保存的完整请求。它们在创建 30 天后被删除。
关于 Dcision 存储的其他内容,参见安全与数据。
谁可以配置什么
| 操作 | 查看者 | 成员 | 管理员 | 所有者 |
|---|---|---|---|---|
| 查看目的地、投递及其状态 | ✓ | ✓ | ✓ | ✓ |
| 添加、编辑和部署目的地 | — | ✓ | ✓ | ✓ |
| 在 Playground 中真实执行目的地 | — | ✓ | ✓ | ✓ |
| 重新发送失败的投递 | — | ✓ | ✓ | ✓ |
| 查看密钥名称 | — | ✓ | ✓ | ✓ |
| 管理密钥和签名密钥 | — | — | ✓ | ✓ |
| 保存 LLM 服务商密钥(设置 → 引擎) | — | — | ✓ | ✓ |
限制
| 限制 | 值 |
|---|---|
| 每个决策的目的地数 | 20 |
| 每次执行触发的目的地数 | 10 |
每次执行的 LLM 回答和 sync 智能体数 | 3 |
| 每个目的地的条件数 | 5 |
| 每个目的地的 params 数 | 30 |
| 固定 param 值 | 最多 500 个字符 |
| 每个目的地的请求头数 | 20 |
| 请求头值 | 最多 2,048 个字符 |
| URL | 最多 2,048 个字符 |
http 请求体模板 | 最多 10,000 个字符 |
| 目的地描述 | 最多 2,000 个字符 |
| 回复文本 | 最多 4,000 个字符 |
| 回复按钮 | 最多 10 个,每个最多 80 个字符 |
LLM 提示词和输入、结构化输出的 instructions 和 input | 各最多 8,000 个字符 |
| 智能体指令 | 最多 32,000 个字符 |
| 智能体工具 | 最多 50 个 |
LLM 和 sync 智能体超时 | 1,000 到 25,000 毫秒,默认 20,000 |
LLM maxTokens | 16 到 2,048,默认 512 |
LLM temperature | 0 到 2,默认 0.3 |
在 response 中返回的智能体回答 | 最多 16,000 个字符 |
| 投递尝试 | 6 次,历时约 7 小时 |
| 投递尝试超时 | 10 秒 |
| 每个工作区的投递 | 每分钟 600 次 |
| 投递保留期 | 30 天 |
| 工作区密钥 | 50 个,值最多 4,096 个字符 |