シークレット管理
安全な認証情報ストレージ
アプリケーションが外部サービスに接続する必要がある場合、たとえば 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 キーをソースファイルへ直接入れないでください。
関連ドキュメント: