Secrets Management

Storage Kredensial Aman

Saat aplikasi perlu terhubung ke layanan eksternal, seperti mengirim email melalui SendGrid, memproses pembayaran dengan Stripe, atau memakai OpenAI untuk fitur AI, Anda perlu menyimpan API key dan kredensial dengan aman. Sistem manajemen secrets Kliv menangani ini otomatis.

Yang membuat secrets aman:

  • Storage terenkripsi di database
  • Tidak pernah ditampilkan penuh setelah Anda menyimpannya
  • Otomatis diinjeksikan ke edge functions saat dibutuhkan
  • Seluruh akun sehingga Anda hanya menyimpan tiap key sekali
  • Jejak audit yang melacak kapan secrets dibuat atau diperbarui

Cara Secrets Bekerja

Saat Anda memberi tahu AI ingin berintegrasi dengan layanan eksternal, AI akan meminta kredensial yang diperlukan. Setelah Anda memberi API key, AI menyimpannya dengan aman memakai nama deskriptif (seperti OPENAI_API_KEY atau STRIPE_SECRET_KEY). Mulai saat itu, edge function mana pun yang membutuhkan kredensial itu dapat mengaksesnya otomatis.

Tampilan termasking: Setelah menyimpan secret, Anda hanya akan melihat versi sebagian termasking di UI admin. Misalnya, sk-proj-abc123xyz789 muncul sebagai sk-p****9789. Ini memungkinkan Anda memverifikasi key mana yang mana tanpa mengekspos nilai penuh.

Injeksi otomatis: Saat edge function berjalan, secrets yang dirujuknya diinjeksikan dengan aman untuk run tersebut. AI menulis function agar membacanya melalui antarmuka secrets platform, dan platform menyediakan nilai sebenarnya saat runtime, sehingga key yang dirotasi berlaku pada run function berikutnya.

Mengelola Secrets

Melalui antarmuka admin, Anda dapat:

  • Melihat semua secrets Anda (dengan nilai dimasking)
  • Menambahkan secret baru atau memperbarui yang ada
  • Menghapus secrets yang tidak lagi dibutuhkan
  • Melihat kapan setiap secret dibuat atau terakhir diperbarui

AI juga dapat membuat dan memperbarui secrets untuk Anda saat Anda menjelaskan integrasi yang ingin dibangun.

Penggunaan Umum untuk Secrets

  • Layanan email: SendGrid, Mailgun, atau kredensial SMTP
  • Pemrosesan pembayaran: Stripe, PayPal, atau API key pembayaran lain
  • Layanan AI: API key OpenAI, Anthropic, atau Google
  • SMS/panggilan: Twilio auth tokens
  • API eksternal: Layanan pihak ketiga apa pun yang diintegrasikan aplikasi
  • Webhooks: Signing secrets untuk memverifikasi webhook masuk
  • Koneksi database: Connection string untuk database eksternal

Praktik Terbaik

✅ Gunakan nama deskriptif - Namai secrets dengan jelas seperti SENDGRID_API_KEY, bukan key1 atau secret.

✅ Rotasi rutin - Perbarui secrets secara berkala, terutama untuk layanan kritis.

✅ Hapus saat selesai - Hapus secrets untuk layanan yang tidak lagi Anda gunakan.

❌ Jangan berbagi secrets - Setiap lingkungan (test, production) harus memakai API key berbeda.

❌ Jangan commit ke kode - Secrets disimpan terpisah dari kode karena alasan tertentu. Jangan pernah menaruh API key langsung di file sumber.


Dokumentasi Terkait: