Astra GateEnglish

隐私护栏原理

检测时机、规则模型与数据安全

隐私护栏的目标:敏感信息不离开本机,同时不破坏客户端的正常使用(脱敏后响应还原,客户端无感知)。

检测时机与对象

  • 检测发生在请求发往上游之前,作用于消息体中的每个字符串值(system、messages、tools 等逐值匹配,不做全文正则扫描整包 JSON);协议自身的不透明字段不检测——base64 图片/文件、thinking 签名、Gemini 的 thoughtSignature(含 Chat 工具调用里的 extra_content.google.thought_signature)、加密推理内容,以及上游签发、按原值配对的 ID——工具调用 ID(Anthropic tool_use.id / tool_use_id、OpenAI Chat tool_calls[].id / tool_call_id、Responses 的 call_id 与条目 id、Gemini functionCall.id / functionResponse.id)和会话续接 ID(previous_response_id、conversation、container、cachedContent):改写会让之后每一轮都被拒。工具参数、工具结果与消息文本照常检测(自定义规则同样如此);
  • 内置「手机号」规则只匹配独立的 11 位号码:前后紧贴字母、数字或下划线的数字串(例如 ID 内部的一段数字)不算手机号。
  • 命中的原值只保存在该请求的内存上下文中,不写入数据库;数据库与日志中只可能出现遮罩样本(如 john••••om)。在「设置 → 隐私」中开启「显示完整命中内容」后,日志会改存命中的原文(每条最多 256 字符)以便调试规则;这会让日志多一份敏感数据,默认关闭。

规则模型

一条规则 = 名称 + 正则表达式 + 动作。内置类别(API 密钥、AWS 密钥、JWT、私钥、邮箱、手机号、内网地址、银行卡号、证件号码、凭据 / 连接串)都是预置规则,可单独启停与改动作;自定义规则完全同构,支持从模板生成(IM Webhook、JDBC 连接串、密钥文件引用、员工工号、车牌号等)。

三种动作:

动作请求响应
仅警告放行—
拦截拒绝(状态「已拦截」)—
脱敏原值 → 占位符([EMAIL_1] …)占位符 → 原值,客户端无感知

响应还原在网关内完成,因此只有 Astra 进程见过原值。

试运行与灰度

  • 只检测不处理(dry-run):记录命中并放行,用于上线前观察误报;
  • 试用检测:控制台里粘贴文本实时验证当前策略;
  • 按类别灰度:高置信(密钥、私钥)先「拦截」,低置信先「警告」。

与请求日志的关系

命中事件出现在两处:隐私护栏页的「拦截日志」,以及对应请求详情的「隐私护栏」区块(已拦截 / 试运行 / 已脱敏 N 处)。把「保存请求与响应内容」打开后,还能对比脱敏前后发给上游的具体内容。