密钥管理
安全凭据存储
当你的应用需要连接外部服务时,例如通过 SendGrid 发送邮件、用 Stripe 处理付款,或使用 OpenAI 提供 AI 功能,你需要安全存储 API 密钥和凭据。Kliv 的密钥管理系统会自动处理这一点。
密钥为什么安全:
- 加密存储在数据库中
- 保存后永不完整显示
- 需要时自动注入到边缘函数
- 账户范围可用,因此每个密钥只需存储一次
- 审计轨迹会跟踪密钥何时创建或更新
密钥如何工作
当你告诉 AI 想要集成外部服务时,它会请求必要的凭据。你提供 API 密钥后,AI 会用描述性名称(例如 OPENAI_API_KEY 或 STRIPE_SECRET_KEY)安全存储它。从那时起,任何需要该凭据的边缘函数都可以自动访问它。
遮罩显示:保存密钥后,你只会在管理 UI 中看到部分遮罩版本。例如,sk-proj-abc123xyz789 会显示为 sk-p****9789。这样你可以确认哪个密钥对应哪个用途,而不会暴露完整值。
自动注入:边缘函数运行时,它引用的密钥会为该次运行安全注入。AI 编写的函数会通过平台的密钥接口读取它们,平台在运行时提供实际值;因此轮换后的密钥会在函数下一次运行时生效。
管理密钥
通过管理界面,你可以:
- 查看所有密钥(以遮罩值显示)
- 添加新密钥或更新现有密钥
- 删除不再需要的密钥
- 查看每个密钥何时创建或最后更新
当你描述想要构建的集成时,AI 也可以为你创建和更新密钥。
密钥的常见用途
- 邮件服务:SendGrid、Mailgun 或 SMTP 凭据
- 付款处理:Stripe、PayPal 或其他付款 API 密钥
- AI 服务:OpenAI、Anthropic 或 Google API 密钥
- SMS/通话:Twilio 认证令牌
- 外部 API:你的应用集成的任何第三方服务
- Webhooks:用于验证传入 webhook 的签名密钥
- 数据库连接:外部数据库的连接字符串
最佳实践
✅ 使用描述性名称 - 像 SENDGRID_API_KEY 这样清楚命名密钥,而不是使用 key1 或 secret。
✅ 定期轮换 - 定期更新密钥,尤其是关键服务的密钥。
✅ 不用时删除 - 移除你不再使用的服务对应的密钥。
❌ 不要共享密钥 - 每个环境(测试、生产)都应使用不同的 API 密钥。
❌ 不要提交到代码 - 密钥与你的代码分开存储是有原因的。永远不要把 API 密钥直接放进源文件。
相关文档: