OpenSRE 护栏Guardrails体系解析如何硬拦截敏感信息与 PII【免费下载链接】opensreBuild your own AI SRE agents. The open source toolkit for the AI era.项目地址: https://gitcode.com/GitHub_Trending/op/opensreOpenSRE 是一个开源的 AI SRE 工具包让你的 AI 智能体自主调查告警、执行运维操作。由于智能体在分析日志、告警时会把大量文本发给外部 LLM敏感信息与 PII个人可识别信息泄露成为真实风险。OpenSRE 内置的Guardrails护栏体系能在每次 LLM 调用前对内容做规则扫描以redact脱敏替换、block硬拦截、audit审计放行三种动作把 API 密钥、信用卡号、私有 Key 等内容挡在模型之外。️ 为什么 AI SRE 需要敏感信息护栏想象这样一个场景你让 OpenSRE 调查一次数据库故障智能体拉取告警、日志、配置发给 LLM 分析——其中可能包含云厂商密钥AWS Access Key、API Token金融数据信用卡号典型的 PII PCI 合规红线基础设施细节内网域名、主机名、Pod/集群名身份凭证JWT、PEM 私钥、GitHub PAT一旦这些内容进入外部模型等于把公司的钥匙串拱手送人。OpenSRE 的护栏正是为此而生在文本离开本地之前完成扫描与处置。⚙️ 核心机制护栏在每次 LLM 调用前运行护栏的工作流程只有四步加载规则首次 LLM 调用时从~/.opensre/guardrails.yml读取规则配置全量扫描每次 LLM API 请求前所有消息内容逐条与规则比对执行动作根据每条规则的动作类型处置匹配内容审计留痕所有匹配写入~/.opensre/guardrail_audit.jsonl审计日志一个关键设计是零配置零开销如果不存在guardrails.yml所有内容原样通过不产生任何性能损耗。启用护栏完全由你掌控。三种护栏动作redact、block、audit动作行为适用场景redact匹配文本被替换为[REDACTED:规则名]不可逆AWS 密钥、API Token、邮箱等 PII 字段block整个请求被拒绝抛出GuardrailBlockedError信用卡号、私钥等绝不该外发的内容audit只记录日志文本原样通过内网域名等想观察但不想改的信息block是最硬的拦截请求根本不会到达 LLM。核心评估逻辑见 infrastructure/safety/guardrails/evaluator.py它还处理了复杂边界情况——当多条规则匹配区间重叠时会合并区间并以最长匹配优先原则保留替换名避免出现部分脱敏的漏网内容。 快速上手3 条命令启用 OpenSRE 护栏护栏通过 CLI 管理上手非常简单# 1. 生成包含常用模式的初始配置AWS 密钥、信用卡、私钥、API Token opensre guardrails init # 2. 用样例文本做干跑测试查看会匹配/脱敏/拦截什么 opensre guardrails test my key is AKIAIOSFODNN7EXAMPLE # 3. 查看当前配置的所有规则及状态 opensre guardrails rules测试命令的输出非常直观——它会告诉你命中了哪条规则、执行了什么动作、以及脱敏后的最终文本$ opensre guardrails test keyAKIAIOSFODNN7EXAMPLE [REDACT] aws_access_key: matched AKIAIOSFODNN7EXAMPLE Redacted output: key[REDACTED:aws_access_key]CLI 实现位于 infrastructure/safety/guardrails/cli.pyinit命令生成的初始配置已内置 5 条生产级规则AWS Access Key、AWS Secret Key、信用卡号、PEM 私钥、通用 API Token。 规则配置指南正则与关键词两种匹配方式规则文件~/.opensre/guardrails.yml每条规则支持regex 正则和关键词列表两种匹配方式均可不区分大小写并可为每条规则指定独立动作rules: - name: aws_access_key description: AWS access key IDs action: redact patterns: - (?:AKIA|ASIA)[A-Z0-9]{16} - name: credit_card description: Credit card numbers action: block patterns: - \\b\\d{4}[- ]?\\d{4}[- ]?\\d{4}[- ]?\\d{4}\\b - name: pii_fields description: Common PII field names action: redact keywords: - social_security - date_of_birth replacement: [PII_REDACTED]几个实用要点自定义替换文本replacement字段可把默认的[REDACTED:规则名]换成更贴合业务的标记软禁用规则enabled: false可临时关闭某条规则而无需删除现成模式库官方文档提供了邮箱、IPv4、GitHub PAT、Slack Webhook、JWT 等常用正则直接抄作业即可完整字段说明与模式库参见 docs/guardrails/README.mdCLI 子命令的解析逻辑在 infrastructure/safety/guardrails/rules.py。 全覆盖拦截哪些 LLM 调用路径受保护护栏不是只在某一个入口生效而是在LLM 客户端层统一拦截覆盖了所有调用路径自定义 Anthropic 客户端LLMClient.invokeOpenAI 兼容客户端OpenAILLMClient.invoke结构化输出调用交互式 Shell 与 Gateway 聊天调用告警提取提示词、行动计划提示词统一的应用入口是 infrastructure/safety/guardrails/apply.py 中的apply_guardrails_to_messages/apply_guardrails_to_text等助手函数被 Anthropic、OpenAI、Bedrock Converse 等各传输层客户端共同调用。此外还有一个巧妙的流式护栏infrastructure/safety/guardrails/stream.py当智能体输出stdout流经/fleet trace等视图时它会按行缓冲、扫描并脱敏防止密钥出现在终端滚动记录里针对流式场景它还会把block动作提升为redact保证输出流不被截断。 互补能力可逆 Masking 掩码体系护栏的 redact 是单向的替换后不可恢复但有时你只是不想把 Pod 名、集群名、账号 ID 这类基础设施标识发给外部模型回答时还想还原出来。OpenSRE 提供了第二层防线——Masking可逆掩码维度Guardrails 护栏Masking 掩码可逆性不可逆替换[REDACTED]可逆占位符如POD_0目标密钥、卡号等硬敏感内容Pod/命名空间/集群/主机名/IP/邮箱等标识位置LLM 客户端层显式选入的调用点启用创建guardrails.yml环境变量OPENSRE_MASK_ENABLEDtrue掩码机制的核心保证是往返一致性同一标识符在同一会话内始终映射到同一占位符POD_0就是那个 Pod保证 LLM 推理连贯mask → unmask可逐字节还原原文。两者可同时启用、各司其职实现纵深防御。掩码文档见 docs/masking.mdx检测器实现位于 infrastructure/safety/masking/。 审计与健康检查验证护栏是否生效拦截了不算完知道拦截了什么才是闭环。护栏内置两层验证手段1. 审计日志所有匹配含 audit 动作都追加到~/.opensre/guardrail_audit.jsonl每条记录包含时间戳、规则名、动作、匹配文本预览截断至 40 字符。随时用一条命令回看opensre guardrails audit审计写入由 infrastructure/safety/guardrails/audit.py 中的AuditLogger负责采用只追加 JSONL 格式写入失败也绝不阻塞主流程。2. 健康检查opensre health会显示护栏当前状态比如guardrails: 5 rules active帮你确认规则确实已加载生效。流式场景下每次检测到密钥还会触发agent_secret_detected分析事件方便团队监控护栏到底拦了多少钱的泄露。 最佳实践清单给刚上手的你 5 条落地建议先 audit后 block新规则先用audit观察一周误报率确认无误伤再升级为redact或block信用卡、私钥一律 block这两类内容没有任何脱敏后发送的价值硬拦截最安全PII 字段用关键词匹配social_security、date_of_birth这类字段名关键词比正则更稳定、更快护栏 掩码双开护栏挡密钥掩码挡基础设施标识覆盖 PII 的主要泄漏面定期opensre guardrails audit把审计日志接入团队的周会复盘让安全可见总结OpenSRE 的护栏体系用一套极简的配置一个 YAML 文件 三种动作redact/block/audit 全路径拦截为 AI SRE 智能体筑起了一道敏感信息与 PII 的硬防线密钥进不了外部模型、拦截留痕可审计、未配置时零开销。配合可逆掩码体系你可以在拥抱外部大模型能力的同时把数据主权牢牢留在本地。【免费下载链接】opensreBuild your own AI SRE agents. The open source toolkit for the AI era.项目地址: https://gitcode.com/GitHub_Trending/op/opensre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考