シークレット管理

安全な認証情報ストレージ

アプリケーションが外部サービスに接続する必要がある場合、たとえば SendGrid でメールを送る、Stripe で支払いを処理する、AI 機能に OpenAI を使う場合、API キーと認証情報を安全に保存する必要があります。Kliv のシークレット管理システムはこれを自動的に処理します。

シークレットを安全にするもの:

  • データベース内の暗号化ストレージ
  • 保存後に完全な形で表示されない
  • 必要なときに edge functions へ自動注入
  • アカウント全体で使えるため、各キーは一度だけ保存すればよい
  • シークレットの作成や更新を追跡する監査証跡

シークレットの仕組み

外部サービスと連携したいと AI に伝えると、AI は必要な認証情報を尋ねます。API キーを提供すると、AI は OPENAI_API_KEY や STRIPE_SECRET_KEY のような説明的な名前で安全に保存します。以後、その認証情報を必要とする edge function は自動的にアクセスできます。

マスク表示:シークレットを保存した後、管理 UI には部分的にマスクされた版だけが表示されます。たとえば sk-proj-abc123xyz789 は sk-p****9789 と表示されます。完全な値を露出せずに、どのキーがどれかを確認できます。

自動注入:edge function が実行されると、その function が参照するシークレットが、その実行のために安全に注入されます。AI は、プラットフォームのシークレットインターフェイスを通じてそれらを読むように function を書き、実際の値はプラットフォームが実行時に供給します。そのため、ローテーションしたキーは function の次回実行から有効になります。

シークレットの管理

管理インターフェイスから、次を行えます。

  • すべてのシークレットを表示する(値はマスクされます)
  • 新しいシークレットを追加する、または既存のものを更新する
  • 不要になったシークレットを削除する
  • 各シークレットがいつ作成または最後に更新されたかを見る

構築したい連携を説明したとき、AI もシークレットの作成と更新を行えます。

シークレットの一般的な用途

  • メールサービス:SendGrid、Mailgun、SMTP 認証情報
  • 支払い処理:Stripe、PayPal、その他の支払い API キー
  • AI サービス:OpenAI、Anthropic、Google API キー
  • SMS/通話:Twilio の認証トークン
  • 外部 API:アプリが連携する任意のサードパーティサービス
  • Webhooks:受信 webhook を検証するための 署名シークレット
  • データベース接続:外部データベース向けの接続文字列

ベストプラクティス

✅ 説明的な名前を使う - key1 や secret ではなく、SENDGRID_API_KEY のように明確に名付けます。

✅ 定期的にローテーションする - 特に重要なサービスでは、シークレットを定期的に更新します。

✅ 終わったら削除する - もう使っていないサービスのシークレットは削除します。

❌ シークレットを共有しない - 各環境(test、production)は異なる API キーを使うべきです。

❌ コードへコミットしない - シークレットは理由があってコードとは別に保存されています。API キーをソースファイルへ直接入れないでください。


関連ドキュメント: