浏览目录和检查就绪度对任何工作区成员免费。安装一个包是
工作区 Admin 动作,并需要付费套餐——网关在服务端执行
两道门控,所以直接的 API 调用无法绕过该门。
1. “安装一个合规包”实际做了什么
一次安装调用原子地向你的工作区写入三样东西:一个防护栏(内容平面)
一个防护栏(内容平面)
包的内容平面控制合并到一个命名的防护栏——
<Pack> (Compliance)(例如 SOC 2 (Compliance))。在观察模式
下,每个动作(以及每个按实体的动作)都被强制为 flag,
所以它标注匹配而不拦截或掩码真实流量。一条防火墙策略(工具调用平面)
一条防火墙策略(工具调用平面)
包的工具调用控制合并到一条命名的防火墙策略——
<Pack> (Compliance — tools)(例如
SOC 2 (Compliance — tools))——在创建时开启 shadow_mode,
于是它评估并把每一次被覆盖的调用记录为 [shadow] would …
但从不拒绝。一条安装记录
一条安装记录
一条工作区合规包行链接这两个实体化策略、钉住目录版本、
记录你选了哪些控制,并戳印谁安装了它——外加一条审计日志
条目。
firewall_policy_id
把防火墙策略附加到一个密钥上——就像你手动编写的任何策略一样。
2. 从控制台安装一个合规包
合规配置使用你的控制台会话(UserAuth),而非中继密钥。 在控制台中操作:打开合规目录
在工作区控制台中转到 Compliance。浏览目录并打开你需要的
框架——例如 SOC 2(
soc2)或 OWASP LLM Top-10
(owasp_llm)。每个包都列出它的控制、每个控制落在哪个
平面,以及官方参考。观察证据,然后上线
让影子防护栏和防火墙积累”本会拦截”的匹配。当姿态看起来
合适时,把包上线以翻开声明的动作,并(可选地)把策略
晋级为你的工作区默认。参见
观察 vs 执行。
3. 底层调用
控制台驱动一个端点。这里把它记录下来,方便你看清它的形态、 审计它,或编写一个内部供应脚本——但网关要求一个工作区 Admin 会话令牌和一个付费套餐才能触达它:mode: observe,以及
实体化的 guardrail_id 和 firewall_policy_id 的 id,让你可以
立刻打开它们。
4. 安装之后
安装是廉价、可逆的第一步:它不耗费任何实时流量,它是幂等的, 而卸载会干净地移除两个实体化平面。有意为之的步骤是上线 ——那才是声明的 block/mask/deny 动作开启的地方。为什么安装而不仅仅是执行就需要付费套餐?把一个框架实体化为
实时可编辑的策略才是价值时刻——网关在安装时和上线时各门控一次,
让升级边界明确,绝不会在推广中途突然冒出一个 403。
5. 相关
套餐门控
究竟哪些合规动作免费,哪些需要付费套餐。
观察 vs 执行
观察模式如何收集证据,以及上线时有什么变化。
控制矩阵
每个框架控制如何映射到网关防护栏和防火墙规则。
OWASP LLM Top 10
映射到本章节中智能体安全威胁的那个包。
防护栏参考
一次安装所实体化的内容平面——规则、PII、动作。
智能体防火墙参考
一次安装所实体化的工具调用平面——判定和执行面。
