密钥管理

安全凭据存储

当你的应用需要连接外部服务时,例如通过 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 密钥直接放进源文件。


相关文档: