Auth Guard

授权保护技能 - 所有外部 API 操作必须经过用户明确授权。这是最高优先级的安全层,确保没有任何自动化可以擅自使用你的授权。核心原则:用户指令是唯一且最优先级。

安装

概览

Auth Guard 是一款专为保护外部 API 操作而设计的授权管理工具,其核心理念是‘用户指令是唯一且最优先的’。它通过强制性的确认机制,在所有自动化流程与外部服务交互之间建立一道坚实的安全防线,确保没有任何未经授权的自动化行为可以绕过人工干预。该工具采用零信任架构原则,默认拒绝所有操作,只有在用户明确允许的情况下才会放行请求。Auth Guard 提供了三种运行模式以适应不同安全需求:STRICT(严格模式)要求每次操作都必须经过用户确认;WHITELIST(白名单模式)允许预批准的操作类型直接执行,但仍对敏感操作保持人工确认;AUDIT(审计模式)则仅记录所有操作而不进行阻止,适用于监控和审计场景。通过灵活的配置选项,用户可以设置通知渠道、超时时间以及详细的审计日志,从而实现对授权行为的全面掌控。

核心功能特点

  1. 强制用户确认:所有外部 API 调用必须经过用户明确授权,确保最高优先级的安全控制
  2. 三种运行模式:支持 STRICT(严格确认)、WHITELIST(白名单免确认)和 AUDIT(仅审计)三种工作模式
  3. 完整审计追踪:自动记录所有授权请求的详细日志,包括时间、操作者、IP地址和操作结果
  4. 灵活的通知集成:支持飞书、Telegram 和 Webhook 等多种通知渠道推送授权请求
  5. 细粒度权限控制:可通过配置文件定义允许或禁止的具体服务操作,并支持时间窗口设置

适用场景

Auth Guard 特别适用于需要严格控制自动化流程访问外部服务的场景。在开发环境中,当 AI 助手或自动化脚本尝试调用邮件、消息等敏感接口时,Auth Guard 会立即弹出确认界面,防止误发邮件或泄露信息。在生产系统中,它可以作为 api-gateway 的前置拦截器,确保所有对外请求都经过人工审核,有效防范自动化攻击和数据泄露风险。对于企业用户而言,Auth Guard 能够统一管理多个技能(skills)的 API 权限,通过白名单机制为高频只读操作提供便利,同时为高风险操作保留人工审批环节。此外,其强大的审计功能使得安全团队可以轻松追溯历史操作记录,满足合规性要求。无论是个人开发者还是大型组织,只要涉及外部服务调用,Auth Guard 都能显著提升系统的安全性和可控性。