密鑰管理

安全的憑證儲存

當你的應用程式需要連接外部服務——例如透過 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 金鑰
  • 簡訊/語音:Twilio 驗證權杖
  • 外部 API:應用程式整合的任何第三方服務
  • Webhook:用於驗證傳入 webhook 的簽章密鑰
  • 資料庫連線:外部資料庫的連線字串

最佳實務

✅ 使用具描述性的名稱 - 密鑰命名要清楚,例如 SENDGRID_API_KEY,而不是 key1 或 secret。

✅ 定期輪替 - 定期更新密鑰,關鍵服務尤其如此。

✅ 用完即刪 - 移除已停用服務的密鑰。

❌ 不要共用密鑰 - 每個環境(測試、正式)都應使用不同的 API 金鑰。

❌ 不要寫進程式碼 - 密鑰與程式碼分開存放自有其道理。切勿把 API 金鑰直接放進原始檔。


相關文件: