SuperAPI AI 工具集

secrets-management

安全与审计

查看项目

更新于 10-15 17:22

技能介绍

用途:该技能用于在项目中安全管理 API 密钥、凭据和敏感配置,核心是使用 secrets.json 文件存放真实密钥,并通过环境变量回退兼容 CI/CD。

主要能力:提供标准文件结构(secrets.json、secrets_template.json、.gitignore、.env),给出 secrets.json 的 JSON 格式示例,以及 Python 加载模式:读取 secrets.json,失败时返回空字典,再用 SECRETS.get("anthropic_api_key", os.getenv("ANTHROPIC_API_KEY", "")) 实现环境变量回退。还包含设置清单和安全最佳实践。

使用方式:创建 secrets_template.json 占位模板;复制为 secrets.json 并填入真实凭据;将 secrets.json 加入 .gitignore;在应用中实现加载逻辑;用 git status 确认 secrets.json 未被跟踪。

适用场景:设置 API 密钥或凭据、创建 secrets.json、实现密钥加载、处理 .env 文件、集成需要认证的外部 API、确保凭据不被提交到 git。

限制与注意:绝不硬编码 API 密钥;始终将 secrets.json 加入 .gitignore;始终提供 secrets_template.json;使用环境变量回退;团队变动后轮换密钥;不要提交真实凭据、记录完整密钥或通过邮件/聊天分享密钥。密钥格式参考:Anthropic 为 sk-ant-api03-...,OpenRouter 为 sk-or-v1-...,OpenAI 为 sk-...,AWS Access 为 AKIA...。更多高级加载、验证、.env 集成、自动化测试、紧急轮换和生产部署策略见 AgentUsage/secrets_management.md。