用途:为 GitHub Agentic Workflows 提供安全设计与配置指导,落地官方五层纵深防御架构。
主要能力:1) 只读令牌:智能体仅获 read 范围 GitHub 令牌,不能推送、建 PR 或删文件;2) 零密钥:写令牌与 API Key 仅存在于隔离的智能体后置作业;3) 容器化与 AWF:Agent Workflow Firewall 经 Squid 代理加域名允许列表,内核级阻断;4) 安全输出:智能体产出结构化工件,独立受控作业仅执行明确允许的动作,支持 max、title-prefix、labels、allowed、close-older-issues、branch、max-size、allowed-exts 等约束;5) 智能体威胁检测:写入前扫描提示注入、凭据泄露与恶意代码,可 action: block。
额外覆盖:最小权限(具体资源权限、细粒度 PAT、timeout-minutes)、safe-inputs 自定义工具有类型校验、网络安全(network: {} 禁止外联、defaults 仅 GitHub 域、显式允许列表)、密钥管理与轮换、提示注入防护、审计日志与监控、人工审批门控、事件响应流程、安全反模式与部署前检查清单,并映射 ISO 27001、NIST CSF 2.0、CIS Controls v8.1。
使用方式:在 GitHub Actions 工作流中,默认 permissions: read-all;为写操作配置 safe-outputs 并设 max 等约束;启用 threat-detection 并设 action: block;需要外网时用 network 显式允许域;密钥放在 GitHub Secrets,不硬编码。示例含最小安全配置、威胁检测、safe-inputs 校验、网络限制、SARIF 报告、资产上传、多层防御与细粒度令牌。
适用场景:设计安全智能体工作流、配置 safe-inputs/safe-outputs 与威胁检测、设置 AWF 规则、公共仓库完整性过滤、智能体工作流安全事件响应。
限制:属规范与指导性技能,不提供具体产品定价或独立运行能力;命令与配置示例须按仓库实际环境调整,生产使用前应完成安全评审。